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Chapter 1 - Introduction 


1.1 


Chapter 1 - 
Introduction 


This specification defines the overall architecture and external interfaces that are required for 
distribution of UEFI/PI source and binary files. 


Overview 


The packaging infrastructure defines the requirements for sharing code (source and/or binary) 
between firmware development teams using UEFI/PI elements. 


This document describes the format of the distribution meta-data file, which has the following 
goals: 


Distributing Package 
An archive of "Packages".An archive of packages. Packages are collections of related 
include files, modules and libraries. Packages provide a method for defining industry 
standard objects used by modules, along with individual modules. 


Distributing Libraries 
Enable source distribution of libraries. 


Distributing Modules 
The final goal is to enable distribution of modules, both in source and binary form. Individual 
modules may be compiled and distributed in binary form to other users, which may be 
integrated easily into a platform's firmware image or option ROMs. Binary distribution is 
limited to FFS leaf section file types. 


This document is intended for distribution package maintainers supporting UEFI/PI development. 
This content is required for the development of Distribution Package creation and installation tools 
and may also be useful for the development of custom Distribution Package tools that utilize the 
extension mechanisms defined in this specification. It may also be of interest if there is an issue 
with the creation, installation or removal of packages. 


1.2 Related Information 


The following publications and sources of information may be useful to you or are referred to by 

this specification: 

¢ Unified Extensible Firmware Interface Specification, Version 2.1, Unified EFI, Inc, 2006, 
http://www.uefi.org. 


¢ UEFI Platform Initialization Specification, Version 1.0, Unified EFI, Inc, 2006, 
http://www.uefi.org. 


¢ Extensible Markup Language (XML) 1.0, Latest Edition, http://www.w3.org/TR/xml/ 
¢* XML Schema Part 0, Latest Edition, http://www.w3.org/TR/xmlschema-0/ 
¢ XML Schema Part 1, Latest Edition, http://www.w3.org/TR/xmlschema-1/ 
¢ XML Schema Part 2, Latest Edition, http://www.w3.org/TR/xmlschema-2/ 
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1.3 Definition of Terms 
The following terms are used throughout this specification. 


BDS 
PI Boot Device Selection phase. 

BNF 
BNF is an acronym for "Backus Naur Form." John Backus and Peter Naur introduced for the 
first time a formal notation to describe the syntax of a given language. 

Distribution Content File 
A file in ZIP format that holds all of the content (include files, libraries, modules) to be 
distributed. 

Distribution Desription File 
A file in XML format that describes the files in the content and the related information 
needed to install the file. 

Distribution Package File 


A file in ZIP format used for releasing and distributing source code or binaries. It contains a 
Distribution Content File and a Distribution Description File. 


DXE 
PI Driver Execution Environment phase. 


DXE SAL 
Special class of DXE module that produces SAL Runtime Services. DXE SAL modules 
differ from DXE Runtime modules in that the DXE Runtime modules support Virtual mode 
OS calls at OS runtime and DXE SAL modules support intermixing Virtual or Physical 
mode OS calls. 

DXE SMM 


Special class of DXE module that is loaded into the System Management Mode memory. 
DXE Runtime 
Special class of DXE module that provides Runtime Services 


GUID and GuidValue 


Globally Unique Identifier. A 128-bit value used to uniquely name entities. A unique GUID 
can be generated by an individual without the help of a centralized authority. This allows the 
generation of names that will never conflict, even among multiple, unrelated parties. 


Human Interface Infrastructure. This generally refers to the database that contains string, 
font, and IFR information along with other pieces that use one of the database components. 


IFR 


Internal Forms Representation. This is the binary encoding that is used for the representation 
of user interface pages. 


Library Class 
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A library class defines the API or interface set for a library. The consumer of the library is 
coded to the library class definition. Library classes are defined via a library class .h file 
that is published by a package. 


Library Instance 


An implementation of one or more library classes. 


Module Developer (MD) 


A module developer is responsible for implementing new modules or maintaining existing 
modules. A module developer is responsible for describing all the information required to 
build a module and also describing the runtime behavior of a module. This description is 
called the Module Surface Area. 


Module Surface Area 


A full description of all of the elements a module produces and/or consumes that allow it to 
be integrated into a platform firmware image and executed as expected. These elements 
included binary file names, source file names, packages, libraries, protocols, PPIs, GUIDs, 
events, Platform Configuration Database elements, UEFI variables, UEFI System 
Configuration Tables, boot modes, HOBs, HII packages, and external variable and function 
names (including the module's entry point). Binary modules must minimally describe the 
dependencies required for a the module to execute correctly. Source modules must 
minimally describe their dependencies so that it can be compiled and linked into a binary 
module. Modules may also have runtime dependencies that must be satisfied in order for the 
module to execute correctly. 


Module Type 
All libraries and modules belong to one of the Module Types listed in Table 1, below. 


Table 1 - 1. Module Type Names 


Name Description 

BASE Module that is environment neutral. Typically only used for libraries. 
SEC Module is the SEC and contains the reset vector. 

PEIM Module is a PEIM and depends on the PEI Services. 


Module is a DXE driver and depends on the EFI Boot Services, EFI Runtime 


EXE BRIVER Services, and DXE Service Table. 


Module is a DXE driver and depends on the EFI Boot Services, EFI Runtime 
Services, and DXE Service Table. The module runs before and after 
ExitBootServices and produces CreateEvent, 
EventGroupExitBootServices, and 
EventGroupVirtualAddressChange. Code written to this 
module can run in physical or virtual mode. 


DXE_RUNTIME_DRIVER 


Module is a DXE driver and depends on the EFI Boot Services, EFI Runtime 
DXE_SAL_DRIVER Services, and DXE Service Table. The module runs before and after 
ExitBootServices and produces CreateEvent, 
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EventGroupExitBootServices, and 
EventGroupVirtualAddressChange. Code written to this 
module can run in physical and virtual mode. 


Module is a DXE driver and depends on the EFI Boot Services, EFI Runtime 
DXE_SMM_DRIVER Services, and DXE Service Table. The module also runs in SMM mode and 
depends on the SMM Services Table. 


UEFI_DRIVER Module is a UEFI driver and depends on the UEFI Services. 


Module is a UEFI driver and depends on the UEFI Services. The module runs 
before and after ExitBootServices and produces CreateEvent, 


UEFI_RUNTIME__ 


DRIVER EventGroupExitBootServices, and 


EventGroupVirtualAddressChange. Code written to this 
module can run in physical or virtual mode. 


UEFI_APPLICATION Module is a UEFI application and depends on the UEFI and Services. 
DXE_CORE Module is the DXE Core. 
PEI_CORE Module is the PEI Core. 


Module may be a binary image, in which the user will have an a priori 


USER_DEFINED 
SER_ knowledge of its usage. 


SMM_CORE Module is the SMM Core. 


Modules 


All module references within this document refer to libraries, PI PEIMs, PI DXE drivers, 
UEFI drivers and UEFI applications. Libraries are mentioned separately, as they are not 
defined as a UEFI/PI image, but instead are linked to a UEFI/PI image during the build. 
Please note that a library can be module, there is no Module Type defined for LIBRARY. 


Package 


A package is a container. It can hold a collection of files for any given set of modules. 
Packages may contain Source Modules, containing all source files and descriptions of a 
module, or Binary Modules, containing PI FFS Sections and a description file specific to 
linking and binary editing of features and attributes or both Binary and Source modules, 
Multiple modules can also be combined into a package. Multiple Packages can also be 
Bundled into a single Distribution Package. 


Package Developer (PD) 


The package developer is responsible for maintaining the contents of a package's 
declarations, which includes the package's name, description, copyright, licenses, and an 
optional set of library and module implementations. Packages may also contain elements that 
are available to the development of new modules by Module Developers. These include 
library class declarations, industry standard include files, include file extensions, GUID 
declarations, protocol declarations, PPI declarations, and platform configuration database 
entry declarations. 


Package Distributor (PDist) 
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The Package Distributor is responsible for creating a distributable version of a package. This 
involves collecting a set of packages developed by Package Developers which includes 
modules developed by Module Developers and combine them into a Distribution Package. 


Package Surface Area 


A complete description of the elements a package provides to support building modules. This 
includes header files for industry standard specifications, library header files, include file 
paths within the package, GUID declarations, PPI declatations, Protocol declarations, and 
Platform Configuration Database element declarations. All of these package elements are 
available to Module Developers and can be used to describe the Module Surface Area of a 
module. 


PCD 
Platform Configuration Database. 


PCD C Name 


The symbolic name for a PCD Token that follows the ANSI C naming conventions for the 
name of a variable. 


PCD Element 


A single configurable element within the Platform Configuration Database, uniquely 
identified by a Token Space GUID and Token Number. 


PCD Token Space GUID 


The GUID value associated with a group of PCD Tokens. Using a GUID allows vendors to 
allocate their own Token Numbers for configuration elements that apply to their own 
modules, libraries or platforms without a centralized allocator. Within the Distribution 
Description file, a PCD Token Space GUID is referred to using the PCD Token Space 
GUID C Name. 


PCD Token Space GUID C Name 


A symbolic name for a PCD Token Space GUID value that follows the ANSI C naming 
conventions for the name of a variable. 


PCD Token 


A 32-bit unsigned integer that, along with the PCD Token Space GUID, uniquely identifies a 
PCD element. Within the Distribution Description File, a PCD Token is referred to using the 
PCD C Name. 


PEI 
Pre-EFI Initialization Phase. 


Platform Configuration Database (PCD) 


The collection of PCD elements that can be configured when building modules, libraries, or 
platform firmware images. These elements are identified by a Token Space GUID and 
Token Number. PCD elements are declared in packages by Package Developers. Modules 
Developers use PCD elements in the design of their modules to increase the portability of 
their modules to a wider array of platform targets. Platform Integrators set the values of 
PCD elements based on specific platform requirements. A Platform Integrator has many 
options when configuring PCDs for a specific platform. They may configure PCD elements 
to be set to static values at build time. They may also configure PCD elements so the binary 
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image of a Module may be patched prior to integration into platform firmware images. They 
may also configure PCD elements so the binary image of platform firmware may be 
patched. They may also configure PCD elements so they can be accessed at runtime through 
the PCD services described in the PI 1.2 Specification. 

Platform Integrator (PI) 


The Platform Integrator is responsible for setting all the features required to build a FLASH 
image and boot a platform. This includes selecting pre-built modules, selecting modules 
implemented by Module Developers, selecting the library instances required to link the 
selected modules, setting the platform configuration database entry parameters for all the 
entries that are used by the selected modules and libraries, and selecting the FLASH layout 
required to store the pre-built module executables in a FLASH device. 

PPI 


A PEIM-to-PEIM Interface that is named by a GUID as defined by the PEI CIS. 


Protocol 
An API named by a GUID as defined by the UEFI specification. 


Runtime Services 
Interfaces that provide access to underlying platform-specific hardware that might be useful 
during OS runtime, such as time and date services. These services become active during the 
boot process but also persist after the OS loader terminates boot services. 

SAL 
System Abstraction Layer. A firmware interface specification used on Intel® Itanium® 
Processor-based systems. 

SEC 


Security Phase is the code that contains the processor reset vector and launches PEI. This 
phase is separate from PEI because some security schemes require ownership of the reset 
vector. 


UEFI Application 


An application that follows the UEFI specification. The only difference between a UEFI 
application and a UEFI driver is that an application is unloaded from memory when it exits 
regardless of return status, while a driver that returns a successful return status is not 
unloaded when its entry point exits. 


UEFI Driver 

A driver that follows the UEFI specification. 

UEFI Specification Version 2.3 

Current version of the UEFI specification released by the Unified EFI Forum. 
Unified EFI Forum 


A non-profit collaborative trade organization formed to promote and manage the UEFI 
standard. For more information, see www.uefi.org. 


WORKSPACE 


A project directory on a development system. 
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The following terms and descriptions are specific to the Module Surface Area defined within this 
specification. 
Feature Flag 
Feature flags are used within the source code as well as by a build system. 
The feature flags represent how the module is coded. For each combination of feature flags 
supported by a module's source code, it is possible to produce a different binary surface 
area. PCD FEATURE_FLAG is a Boolean, so the relationship of each module surface area 
element to a binary can be expressed as a Boolean expression. The lack of a conditional 


expression implies TRUE, and the source code surface area element will be in all resulting 
binaries. 


The Feature Flag can also be used by the build system to conditionally include or exclude 
different items (library classes, source files, etc.) from a build. 


Consumes 


Any item with a Usage Attribute of Consumes means that a module will not function without 
it. The module will either fail to execute, fail to build or fail to link if the item is not present 
when needed. 


Produces 


Any item with a Usage Attribute of Produces means that a module defines this specific 
instance of the item. 


Sometimes Consumes 


Any item with a Usage Attribute of Sometimes Consumes means that if the item is 
available, the item will be used, but the module may continue to function if the item is not 
available. 


Sometimes Produces 


Any item with a Usage Attribute of Sometimes Produces means that a module defines this 
specific instance of the item under certain conditions or under different execution paths. 


ToStart 
The protocol is required by the driver binding Start() function to make Start() succeed. 


ByStart 
The protocol is produced by the driver binding Start() function if it succeeds. 


1.4 Target Audience 


This document is intended for persons doing Package Development and Package Distributors. 


1.5 Conventions Used in This Document 


This document uses the typographic and illustrative conventions described below. 


Note that each of the types with the prefix 'xs:' are built in to XML Schema. Full definitions of 
these simple types can be found online, http://www.w3.org/TR/xmlschema-0/#CreatDt. 


1.5.1 Table Conventions 
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Table 1 - 2. Base XML Data Types 


Name 


xs:boolean 


xs:decimal 


xs:integer 


xs:nonNegativelnteger 


xs:string 


Char 


xs:normalizedString 


xs:NCName 


xs:anyURI 


xs:language 


xs:Nmtoken 


Table 1 - 3. Value Types 


xs:hexBinary 


HexNumber 


Md5Sum 


CFormatGuid 


Description 


A string containing ‘true’ or ‘false’ 


A string containing numbers followed by a period followed by numbers 
Example: 1.23 


A string that represents a signed 32-bit integer. The range is from 
-2147483648 to 2147483647 


A string that represents a positive 32-bit integer. The range is from 0 to 
4294967295 


The set of finite-length sequences of characters that match Char 


#x9 | #xA | #xD | [#x20-#xD7FF] | [#xE000-#xFFFD] | [#x10000- 
#x1OFFFF] 


The set of strings that do not contain the carriage return (#xD), line feed 
(#xA) or tab (#x9) characters. 


A string that start with a letter or an underscore and is followed by any 
combination of letters, digits, periods, hyphens, and underscores. No 
whitespace characters are allowed. 


A finite-length character sequences which are legal URIs according to 
[RFC 2396], as amended by [RFC 2732] 


The language code entered must conform to RFC 1766. 


A string that contains any combination of letters, digits, periods, hyphens, 
and underscores. No whitespace characters are allowed. 


Description 


A string that contains any number of hexadecimal characters (0-9a-fA-F) 


* 


Example: F0040001 


This simple type extends xs:hexBinary with a ‘Ox’ prefix. 
Example: 0xF0040001 


A string of 32 hexadecimal characters that does NOT start with “Ox.” 


A straing containing a GUID in C data format, either new or simple style. 
Example Simple: {Oxyyyyyyyy, Oxyyyy, Oxyyyy, Oxyy, Oxyy, Oxyy,Oxyy, 
Oxyy, Oxyy, Oxyy, Oxyy} 

Example New: {Oxyyyyyyyy, Oxyyyy, Oxyyyy, {Oxyy, Oxyy, Oxyy,Oxyy, Oxyy, 


Oxyy, Oxyy, Oxyy}} 
Where yy is a hexadecimal digit, whitespace characters are ignored. 


RegistryFormatGuid 


GuidValue 


GuidCName or CName 
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A string containing a GUID in registry format. 
Example: AFODDA2E-EA83-480b-B2CE-FCOBB2F894C2 


A string containing a GUID formatted as a RegistryFormatGuid. 


A C variable format word that can be used as a cross reference to 


Table 1 - 4. Enumeration Types 


FamilyType 


GuidTypes 


ModuleType 


Description 


A string that contains a single Arch type. The Arch type is restricted to the 
following set: 

IA32 

X64 

IPF 

EBC 

ARM 

Pattern = [A-Z] ([a-zA-Z0-9])* 


A string that contains a single Family type. The Family type is restricted to 
the following set: 

MSFT 

GCC 

Pattern = [A-Z] ([a-zA-Z0-9])* 


A string that contains a single GUID type. The GUID types are restricted 
to the following set: 
Event 

File 

FV 

GUID 

HII 

HOB 
SystemTable 
TokenSpaceGuid 
UNDEFINED 
Variable 


A string that contains a single module type. Module types are restricted 
to the following set: 

BASE 

SEC 

PEI_CORE 

PEIM 

DXE_CORE 
DXE_DRIVER 
DXE_RUNTIME DRIVER 
DXE_SAL DRIVER 
DXE_SMM DRIVER 
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PcdDatumType 


PcditemTypes 


SupportedOs 


Table 1 - 5. List Types 


ArchListType 


Description 


SMM _ CORE 

UEFI_DRIVER 

UEFI_RUNTIME DRIVER 

UEFI_APPL ICATION 

USER_DEFINED 

Pattern = [A-Z] ([a-zA-Z0-9])* 


A string that contains a single PCD Data Type. PCD Data Types are 
restricted to the following set: 

UINTS8 

UINT16 

UINT32 

UINT64 

VOID* 

BOOLEAN 


A string that contains one PCD Entry item types. The PCD Entry item 
types are restricted to the following set: 

FeaturePcd 

FixedPcd 

PatchPcd 

Pcd 

PcdEx 


A string that contains one Supported Operating System type. The 
Supported Operating System types are restricted to the following set: 
Win32 

Win64 

RedHat32 

RedHat64 

SuSE32 

SuSE64 

Generic 

GenericWin 

GenericNix 

Pattern = [A-Z] ([a-zA-Z0-9])* 


Description 


A string that contains one or more CPU architectures separated by 
spaces. The CPU architectures are restricted to the following set: 
IA32 

X64 

IPF 

EBC 

ARM 


Se 


GuidListType 


ModuleListType 


PcdltemListType 
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Description 


Pattern = [A-Z] ([a-zA-Z0-9])* 


A string that contains one or more GUID types separated by spaces. The 
GUID types are restricted to the following set: 
Event 

File 

FV 

GUID 

HII 

HOB 

SystemTable 

TokenSpaceGuid 

UNDEFINED 

Variable 


A string that contains one or more module types separated by spaces. 
The module types are restricted to the following set: 
BASE 

SEC 

PEI_CORE 

PEIM 

DXE_CORE 

DXE_DRIVER 

DXE_RUNTIME DRIVER 

DXE_SAL DRIVER 

DXE_SMM DRIVER 

SMM_CORE 

UEFI_DRIVER 

UEFI_RUNTIME DRIVER 
UEFI_APPLICATION 

UNDEFINED 

USER_DEFINED 

Pattern = [A-Z] ([a-zA-Z0-9])* 


A string that contains one or more PCD Entry item types separated by 
spaces. The PCD Entry item types are restricted to the following set: 
FeaturePcd 

FixedPcd 

PatchPcd 

Pcd 

PcdEx 


Table 1 - 6. Table Description 


Description 


Required 


This is the description of this element 


YES | NO - Is this element required by the parent element 


atte 
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Data Type 


Data Constraints 


Examples 


[Attribute | Element] — [Complex | Data Type] 


What are the limitations or possible values for this element 


Either N/A or a hypothetical example 


1.5.2 Pseudo-Code Conventions 


Pseudo code is presented to describe algorithms in a more concise form. None of the algorithms in 
this document are intended to be compiled directly. The code is presented at a level corresponding 


to the surrounding text. 


In describing variables, a list is an unordered collection of homogeneous objects. A queue is an 
ordered list of homogeneous objects. Unless otherwise noted, the ordering is assumed to be First In 


First Out (FIFO). 


Pseudo code is presented in a C-like format, using C conventions where appropriate. The coding 
style, particularly the indentation style, is used for readability and does not necessarily comply 
with an implementation of the Extensible Firmware Interface Specification. 


1.5.3 Typographic Conventions 


This document uses the typographic and illustrative conventions described below: 


This document uses the typographic and illustrative conventions described below: 


Plain text The normal text typeface is used for the vast majority of the 
descriptive text in a specification. 


Plain text (blue) In the online help version of this specification, any plain 
text that is underlined and in blue indicates an active link to the cross- 
reference. Click on the word to follow the hyperlink. Note that these 
links are not active in the PDF of the specification. 


BoldIn text, a Bold typeface identifies a processor register name. In 
other instances, a Bold typeface can be used as a running head within a 
paragraph. 

Italic Yn text, an Italic typeface can be used as emphasis to introduce a 
new term or to indicate a manual or specification name. 


BOLD MonospaceComputer code, example code segments, and all 
prototype code segments use a BOLD Monospace typeface with a 
dark red color. These code listings normally appear in one or more 
separate paragraphs, though words or segments can also be embedded in 
a normal text paragraph. 


Bold Monospace In the online help version of this specification, 
words ina Bold Monospace typeface that is underlined and in blue 
indicate an active hyperlink to the code definition for that function or 
type definition. Click on the word to follow the hyperlink. Note that 
these links are not active in the PDF of the specification. Also, these 
inactive links in the PDF may instead have a Bold Monospace 
appearance that is underlined but in dark red. Again, these links are not 
active in the PDF of the specification. 
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Italic Monospace Incode or in text, words in Italic 
Monospace indicate placeholder names for variable information that 
must be supplied (i.e., arguments). 
Plain Monospaceln code, words ina Plain Monospace 
typeface that is a dark red color but is not bold or italicized indicate 
pseudo code or example code. These code segments typically occur in 
one or more separate paragraphs. 
See the references sections in the UEFI 2.1 Specification for a complete list of the additional 
documents and specifications that are required or suggested for interpreting the information 
presented in this document: 
The UEFT Specification is available from the UEFI web site http://www.uefi.org/specs. 
See the references sections in the UEFI Platform Initialization Specification Version 1.0 for a 
complete list of the additional documents and specifications that are required or suggested for 
interpreting the information presented in this document: 
The UEFT Platform Initialization Specification is available from the UEFI web site 
http://www.uefi.org/specs. 
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Chapter 2 - 
Design Discussion 


UEFI and PI components made of different collections of related objects are called packages. 
Individual packages may be updated without having to update other packages, so as tools, or 
architecture specifications are updated, only the relevant packages need to be updated. If an 
architecture specification changes, the corresponding distribution package containing the 
architecture definition package can be downloaded, without downloading an entire development 
tree. If new tools are released, a new tools distribution package can be distributed without 
disturbing the contents of the other packages. As industry standards evolve, updates to the 
standards (typically defined in header files) can be released, again, without having to get an 
entirely new tree. 


This document uses two different concepts for the term “package.” The first is a distribution 
package; for clarity, this document will use the term “distribution” when referring to a distribution 
package. The other usage of package is a collection of related objects — Includes, Libraries and 
Modules. A distribution package may contain zero or more of the packages, while each package 
may contains zero or more modules. (Why zero? — A package can consist of nothing but industry 
standard headers. While most industry standard headers may need to provide library routines, there 
is no requirement for providing them.) Each package typically has it’s own folder or directory. 


Purpose 


In order to provide a consistent process for sharing drivers and code, this specification introduces 
the concept of a Package Surface Area and a Module Surface Area which document the surface 
area of packages and modules. These surface areas include many concepts from the UEFI 
Specification and and PI Specification as well as a Platform Configuration Database. 


The Platform Configuration Database is the collection of elements that can be configured when 
building modules, libraries, or platform firmware images. These elements are identified by a 
Token Space GUID and Token Number. PCD elements are declared in packages by Package 
Developers. Modules Developers use PCD elements in the design of their modules to increase the 
portability of their modules to a wider array of platform targets. Platform Integrators set the values 
of PCD elements based on specific platform requirements. A Platform Integrator has many options 
when configuring PCDs for a specific platform. They may configure PCD elements to be set to 
static values at build time. They may also configure PCD elements so the binary image of a 
Module may be patched prior to integration into platform firmware images. They may also 
configure PCD elements so the binary image of platform firmware may be patched. They may also 
configure PCD elements so they can be accessed at runtime through the PCD services described 
in the PI Specification. 


A PCD element is identified by a Token Space GUID and a Token Number. The Token Space 
GUID is a GUID value that is associated with a group of PCD Tokens. Using a GUID value 
allows vendors to allocate their own Token Numbers for configuration elements that apply to their 
own modules, libraries or platforms without a centralized allocator. Token Space GUID values 
must be declared in a surface area for a package along with a symbolic name for the GUID. This 
symbolic name is called the Token Space GUID C Name. Token Number must also be declared in 
the surface area for a package along with the symbolic name for the PCD Token. This symbolic 
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name is called the PCD C Name. If a module uses a PCD element, then that usage is described in 
the surface area of the module, and the PCD element in the surface area of a module is identified 
using the symbolic name for the Token Space GUID and the symbolic name for the PCD Token. 
This means the module surface area only references the Token Space GUID C Name and the 
PCD C Name. This is much easier to read and maintain than the GUID values and Token 
Numbers. 


The surface area of a package is the complete description of the elements a package provides to 
support building modules. These elements include: 


* Header files for industry standard specifications 

¢ Library header files 

* Include file paths within the package 

¢ GUID declarations 

¢ PPI declarations 

* Protocol declarations 

¢ Platform Configuration Database element declarations 


The surface area of a module is a full description of all of the elements a module produces and/or 
consumes that allow it to be integrated into a platform firmware image and executed as expected. 
These elements included: 


¢ Binary file names 
¢ Source file names 
* Packages 
¢ Libraries 


* Protocols 


¢ PPIs 
« GUIDs 
« Events 


¢ Platform Configuration Database elements 

¢ UEFI variables 

¢ UEFI System Configuration Tables 

¢ Boot modes 

* HOBs 

¢ HII packages 

¢ External variable and function names, including the module's entry point 


Binary modules must minimally describe the dependencies required for a the module to execute 
correctly. Source modules must minimally describe their dependencies so that it can be compiled 
and linked into a binary module. Modules may also have runtime dependencies that must be 
satisfied in order for the module to execute correctly. 


The surface area of a module describes how a module can be integrated quickly into a new 
project. The surface area descriptions can be broken down into source, binary, and library 
integration. 


LN6e 


Chapter 2 - Design Discussion 


Key module surface area features include: 
¢ The module surface area describes all things visible to the system from a binary module. 
¢ The module surface area describes information needed to construct and link modules. 
¢ The module surface area does not describe everything in the source code of a module. 
e This is very complicated and C source code does a good job of this. 
¢ A module must inherit the module surface area of the library linked to that module. 
¢ The module surface area describes only the library class and not the library instance. 
¢ The library instance linked to a module or library is determined at link time. 


¢ The complete module surface area of a module can only be determined after library 
instances have been selected. 

The challenge with integrating at a source level is that the surface area of the module might 
contain conditional statements that define different binaries based on the build options that are 
chosen. A binary needs to describe how it was built; it is not necessary to describe how it could be 
built if no source were included. If a binary supports patching, the binary also needs to describe 
the option and how to patch it, while the source surface area would need to describe only the 
option. 
While it’s possible to categorize a library as either a source or binary integration point, subtle 
differences warrant libraries having their own category. The primary difference is that libraries 
are often included into modules. This means the consumer of a library must inherit the module 
surface area of the libraries linked to the module. 


One of the biggest challenges with the module surface area will be making the initial description 
correct and maintaining this correctness as the module is maintained. For this reason, the build 
environment should be strongly tied to the surface area description. For example, if you don’t have 
a HOB element in the module’s surface area description, using HOBs would prevent the module 
from compiling until the surface area description was updated. A large number of the surface area 
grammar elements are GUIDs, so tying compile time GUID resolution to a module surface area 
would go a long way toward making sure the surface area is always defined correctly. It’s not 
practical to make a 1:1 mapping between the surface area grammar and making the module 
compile, but having a 60%-80% mapping will give the developer the mind set of updating the 
surface area description when changes are made to the driver. 


2.2 Surface Area Description 
The surface area consists of the following parts: 
Usage Description 
Describes how the element is used. 
Element 
Describes the surface area element. 
Conditional 
Optional definitions of what PCD feature flags this element is valid for. 
Default 
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An optional, recommended default value for the element. This is generally used by the 
platform integrator as a guide in selecting what value should be used on a given platform for 
a given PCD value. 


Help Text 
Each surface area element can optionally include help text. 


The usage description defines how an element is coded or used by a module. The usage includes 
production or consumption and whether the element is always or only sometimes used by the 
driver. The element describes exactly what the module is producing or consuming. 


The optional conditional statement can be used to qualify the surface area statement to be valid 
only if the module is built a certain way. If no conditional exists, it is assumed to be TRUE, and 
the surface area statement is valid for all ways the module can be built. The conditional statement 
is a Boolean expression of PCD Feature Flags. 


2.2.1 Conditional Surface Area Entries 


Some surface area entries might be in the source code, but not in the resulting binary. The module 
surface area of the source code describes what’s in the source code, while the module surface 
area of a binary describes what and how the module was built. If a module does different things 
for different processor types, the surface areas of the resulting binaries are different. Thus, it’s 
important to think of the module surface area in terms of the source code and the binary. The 
surface area description for the source code is easy — if an element is in any of the source code, 
it must be in the module surface area for the source code. The module surface area for a binary is 
more complex. The build system can construct code for different processor architectures in 
radically different ways, if needed, and the resulting module surface area for the binary needs to 
reflect only what was constructed. 


It’s also possible that a PCD Feature Flag could cause surface area elements that are in the source 
code to not be in the resulting binary. 
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Module Surface Area 


Source Code 


Feature Flag A & B & IPF Feature Flag (C | D) & !IPF 


Module Surface Area Module Surface Area 


Binary A Binary B 


Figure 2-1. Module Surface Area Differs for Different Binaries 


Figure | illustrates how the surface area is different for the source code and the different binaries 
that can be produced from common source code. In the above example, the surface area of the 
binary differs based on processor type: for Itanium® Processor binaries you get surface area A, 
and for non-Itanium® Processor binaries you get surface area B. A and B are both subsets of the 
source code surface area, as only things that are in the source code can end up in the binary. 


The feature flags must represent how the module is coded. For each combination of feature flags 
supported by a module's source code, it is possible to produce a different binary surface area. 


PCD "FeaturePcd" is a Boolean, so the relationship of each module surface area element to a 
binary can be expressed as a Boolean expression. The lack of a conditional expression implies 
TRUE, and the source code surface area element will be in all resulting binaries. 


2.2.2 Surface Area Inheritance 


The module surface area for a driver describes how the driver is coded. The previous section 
describes how PCD "FeaturePcd" can impact the resulting surface area of the binary produced 
when the module is compiled and linked. The surface area for the binary must also inherit surface 
area elements from any linked library instance. 


The surface area for a driver specifies only the class of the library. 


2.2.3 Source Code Surface Area 
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The distinguishing feature of the source code surface area is that it outlines a set of options in the 
form of PCD-based build flags. The runtime surface area is a proper subset of the build-time 
surface area. 


2.2.4 Informational Surface Area 


Example: PCD:UsbEnable flag. There may be a driver that does not use the UsbEnable flag as this 
driver is an UEFI driver that produces USB interfaces. If the platform has no USB, this driver 
should not be included in the build. There may be other drivers, such as ICH USB, that need to 
conditionally compile to not program certain registers based on UsbEnable. The ICH driver would 
define the PCD flag in the normal location. The UEFI USB driver would describe an informational 
surface that was a parallel of the build-time surface area to help people whether it should be 
included in the build. 


2.2.5 Conditional Descriptions 


PCD entries of the type build can also be used to describe the surface area in a conditional way. 
All PCD values must be available to all build tools, usable in all build and packaging files. This is 
in addition to the requirement to include PCD entries as static data, dynamic data, or binary 
patchable data in a module. 


2.2.6 Binary Surface Area 


The binary surface area defines the surface area of a module when it executes its code. The 
binary surface area is a subset of the source code surface area. Descriptions of possible build 
options are not needed, and only elements consistent with the current compile options are defined. 


2.2.7 Hardware Surface Area 
This area is not fully explored in this version of the specification. Areas of interest include: 


¢ "Defining hardware settings for CMOS (and other indexed I/O devices), I/O, memory mapped, 
and PCI hardware devices. 


* "Usage to define which base registers a driver assumes are already programmed in a chip that 
is being programmed. 


« "May be used to define which PCI devices a UEFI or DXE driver could support. 


2.3 Surface Area Grammar 


The surface area grammar defines how a module either produces or consumes public interfaces or 
elements. There are seven universal usage descriptions (see Usage Description table below) that 
can be applied to any of the grammar elements. Usage descriptions define how a module either 
produces or consumes a public interface or element. A module may require (CONSUMES), 
conditionally require (SOMETIMES CONSUMES), or need an interface to bind the driver using the 
UEFI driver model (TO_START). A module may always produce (PRODUCES), conditionally 
produce (SOMETIMES PRODUCES), or produce an interface following the UEFI driver model 
(BY_START). 


Table 2 - 1. Usage Description 
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Description 


Element is required for the driver to function. This means the element is 

part of the dependency expression of a module if the element represents 
a PPI or Protocol. For the most part, any GUID, Protocol, PPI or PCD that 
doesn’t install (PRODUCES) something will be one form of CONSUMES. 


CONSUMES 


SOMETIMES _ 


Element is consumed by the driver only if the element exists. 
CONSUMES ee 


PRODUCES Element is always produced (installed) by the driver 


SOMETIMES _ 


PRODUCES Element is conditionally produced by the driver 


Protocol is required by driver binding Start () function to make 


TO START 
= Start () succeed. 


BY_ START Protocol is produced by driver binding Start () function if it succeeds. 


PEI and DXE drivers define their dependencies in the terms of the PPIs or protocols that they 
require to be present in the system before the given module would be executed. While this works 
well for ordering the execution order of modules it is not a sufficient description to easily port a 
module into a new project. The grammar defined in the table below, can be used to define which 
public interfaces a module produces or consumes. Each element of the grammar can be clarified 
by combining it with a usage description. 


For each element, Table 8 gives the type of name required to specify the instance of the element 
and a description of the element. 


Table 2 - 2. Surface Area Grammar Summary 


Name Type Description 


Packages are the basic unit of source code and binary 
module distribution. A single package can imply (depend 
on) other packages. Only the leaf package needs to be 
specified in this case. Packages are named by GUID (and 
version.) Packages generally make include files and 
libraries available to modules. 


Package 


Defines a class of libraries that provide similar features 
(prototypes are defined in a library class header file 

LibraryClass Keyword provided by a package.) There may be more than one 
library instance that can provide the feature. (See 
Libraries.) 


A module needs to explicitly state the library functions it 


uses (by including the library class header file that contains 
Libraries the function prototypes.) A Keyword specifies the class of 
the library; while a GUID specifies the name of the library 
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Element Name Type 


Protocol 


ProtocolNotify 


PpiNotify 


Event (Create) 


Event (Signal) 


FileName 


GUID 


Pcd.$(database) PCD lItem:{Type} 


Description 


instance. Multiple libraries can support the same class, so 
it's not possible to declare the library instance in the source 
code. The build environment must know the mapping of 
library classes to actual library instances. The library 
instances are selected by the Platform Integrator. Library 
Instances always provide (PRODUCES) library functions, 
they may required (CONSUMES or SOMETIMES _ 
CONSUMES) other library functions in order to function. 


Specifies whether a protocol named by GUID is 
CONSUMES, SOMETIMES CONSUMES, 
PRODUCES, or SOMETIMES PRODUCES. 


Specifies whether a module requires or consumes a 
protocol, named by a GUID, via a register protocol notify 
mechanism. Valid usage can only be SOMETIMES _ 
CONSUMES. 


Specifies whether a PP! named by GUID is CONSUMES, 
SOMETIMES CONSUMES, PRODUCES, or 
SOMETIMES PRODUCES. 


Specifies whether a module requires or consumes a PPI, 
named by GUID, via a register protocol notify mechanism. . 
Valid usage can only be SOMETIMES CONSUMES. 


Module has an event that is waiting to be signaled 
(CONSUMES or SOMETIMES CONSUMES.) The event 
is named by GUID. UEFI 2.0 added CreateEventEx 
and maps the existing EFl events back to GUIDs. 

EVENT _GROUP_GUID 

EVENT TYPE PERIODIC TIMER 

EVENT TYPE RELATIVE TIMER 


Module will signal all events in an event group 
(PRODUCES or SOMETIMES PRODUCES.) Event 
groups are named by GUID just like CreateEvent. 


FV Filename GUID. 


A GUID that is not described by one of the other types in 
this table. 


Platform Configuration Database (PCD) represents a set of 
GUI|Ded databases containing sets of items. Packages 
publish PCD basenames. A module can be built with a 
hard-coded value for an Item, with the Item being dynamic, 
or with the Item being a value that can be binary patched. 
$(database) is a GUID. No GUID implies the default PCD 
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Element Name Type Description 
database. 
{Type} Description 


The PCD Item represents a feature flag for the module. 
Features can be selected only at build time. Items of type 

FeaturePcd FeaturePcd are used to conditionally construct a 
module surface area that is produced as a result of the 
build.A FeaturePcd mustbe a Boolean. 


PCD Item is only a build-time option and can not be 
Dynamic or binary patched into the module (PatchPcd). 


FixedPcd 


Module Surface Area for Source Code: 

PCD Item {Type} is set to a default value at build time and 
the binary of the module can be patched to update the 
value. FixedPcd implies the build assigns a value 
when the module is compiled. PatchPcd implies the 
build patches the module binary as part of the build option. 
The PatchPcd is most useful if you don’t have source 
code to a module that you are including in the build. 


PatchPcd 


Module Surface Area for Binary: 

The binary must also describe the location within the 
binary to patch. The surface area must describe the file 
offset into the uncompressed PE32+ image to associate 
with the PCD entry. This can be a UINT32 (max PE32+ 
image size) offset. It may also be useful to specify the label 
name in the image of the PCD entry. 


Module Surface Area for Source Code: 

This dynamic form implies the source code contains a 
macro that will be resolved via a build option into 
FixedPcd, PatchPcd, or Pcd. If no {Type}is 
present, it defaults to Pcd. This allows the user of the 
module (Platform Integrator) to pick the type as the module 
is coded to allow all three. 


Module Surface Area for Binary: 

PCD Item {Type} is found via a PCD PPI in PEI or PCD 
protocol. The token that matches the PCD entry is either 
generated by the build (only unique to the build) or is from 
the default database. 


PCD Item {Type} is found via PCD PPI in PEI or PCD 


PcdE 
ai protocol in DXE. Any PCD token database is supported. 


An EFI variable described by a GUID string pair. No {offset} 


Variabl ID:Stri ffset 
hes SUID Stingiotset value implies the entire variable is used. 
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Element Name Type Description 


The first {offset} entry represents the byte offset to the start 
Byte of the data. The names Byte is not part of the syntax and 
actual numbers must be used. 


An EFI system table entry identified by a GUIDed system 
table is CONSUMES, SOMETIMES CONSUMES, 
PRODUCES, or SOMETIMES PRODUCES bya 
module. 


SystemTable 


Type of module being developed. An instance of a library 


ModuleType ModuleT 
yP te can support more than one ModuleType. 


A module uses BootMode to define the boot modes it can 
set (PRODUCES or SOMETIMES PRODUCES) or the 

BootMode BootMode boot modes it supports (SOMETIMES or SOMETIMES _ 
CONSUMES.) Not having this element implies no boot 
mode is set and all boot modes are supported. 


Represents a HOB that is being produced or consumed. A 
HobType HobType of GUID_ EXTENSION requires that the 
name of the GUID being used is also required. 


IFR form set was added (PRODUCES or SOMETIMES _ 
PRODUCES) by this module via the HII protocol. 


FormSet GUID 


Extern C Identifier Name Libraries can depend on externally defined symbols. 


2.4 Distribution 


A Distribution Package File is a file (ZIP format) that contains two files: a Distribution 
Description File (XML format) and a Distribution Content File (ZIP format). Installations and 
updates using these Distribution Package Files follow rules to prevent package collisions and 
permit relocating packages (and modules) to different directory names during an installation. 


The Distribution Description File provides a description of the content provided by the Distribution 
Content File. The content described includes every package, module and tool, as well as any 
miscellaneous items. Additionally, the package and module surface area descriptions within the 
Distribution Package Desription File document any dependencies and describe how a module is 
coded, what resources the module produces or consumes, and, in the case of binary modules, how 
the binaries in the module were built. 


2.5 Tracking 


Packages and all modules within any given package are identified using GUID values and 
VERSION numbers. The surface area descriptions use these GUID and VERSION values to 
describe dependencies. If a module depends on a specific package, the package’s GUID version 
should be specified in the module’s package dependencies section to identify the package. If the 
module is coded so that it will not depend on a specific version of a package, the VERSION can 
be omitted. However, if a module requires a specific version of a package to satisfy a dependency, 
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then both the GUID and VERSION of the package must be listed. If VERSION is omitted and 

there are more than one packages with the same GUID installed in the workspace the package 

with the highest VERSION value will be used. 

Additionally, this document introduces the concept of modules that are coded against classes of 
libraries, rather than individual library instances. This method permits the platform integrator to 
select specific instances of libraries that satisfy the library classes a module was coded against. 
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3.1 


Chapter 3 - 
Distribution Package File 


The Distribution Package File format is the format of the file used in distributions. Instead of 
building or specifying an entirely new archive format, the Distribution Package File simply extends 
a widely accepted industry standard ZIP file format. The ZIP format already supports most of the 
features or capabilities required by Distribution Package Files, including: 


* Compression 

* Cross-platform support 

* Encryption 

The Distribution Description File is a meta-data file that all distributions are required to contain. 


The Distribution Description File is an XML formatted file with a .pkg file extension that resides 
in the root directory of the Distribution Package File. 


The Distribution Package File also holds all of the Include files, Libraries and or Modules. These 
files are contained in the Distribution Content File, a ZIP formatted file with a .content file 
extention that resides in the root directory of the Distribution Package File. Keeping the meta-data 
information about what is being distributed and the content separate provides a clean separation 
between the two distinct elements. 


Distribution Requirements 

The Distribution Package File containing the Distribution Description File and the Distribution 
Content File must have the file extension of .dist. 

A Distribution Package File may contain: 

1. Zero or more packages. 

2. Zero or more modules. 

3. Zero or more tools. 
4 


Additional files that do not match either a package surface area declaration, module surface 
area or tools. 


The Distribution Package File consists of two parts: 


¢ The Distribution Description File, which is the XML formatted data describing the 
Distribution Content. 


¢ The Distribution Content File, which is the compressed package tree. 


Any additional files within the Distribution Content File may be ignored. 
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Distribution Description File 
Jj <DistributionHeader ReadOnly"true" 
/  RePackage"false"> 
7 <Name BaseName"NosuchChipset'>Nosuch 


. . . / Chi 
: pset</Name> 
Distribution / <GUID Versiom"1.2"> AFODDA2E-EAS3-48(-B2cCE- 
i ® FCOBEQF894C2 </GUID> 
Package File / <Vendo® Nosuch Corporation</Vendor 
(ZIP dist) / <Date>2008-03-24709 : 30: 00</Date> 
J . <CopyrightCopyright (c) 2008, Nosuch 


Corporation All rights reserved</Copyright 
Distribution 
Description File (XML, Pd 
-Pkg) - 


¢ 
< 2 es Soe : 
Dpeibuton Conn a Distribution Content File 
File (ZIP, .content) 
— = 
\ bor 
\ — rpe 
\ | btus 
. ;o) 
\ 1 | b—feert 
\ It break 
\ | 1 super une 
\ | Ftnclude 
‘ ee 
\ ee 
\ 


Figure 3 - 1. Distribution Package File layout 


3.1.1 Creating a Distribution Package File 


Normally, a Distribution Package File is created from a directory tree located in a directory on a 
developer's workstation. The typical directory tree is a hierarchy of directories and files that are a 
collection of declarations and modules. This directory tree may contain an Includes directory, a 
Library directory which has library modules (instances) directories beneath it, and module 
directories that contain drivers, applications and/or other non-library modules. Figure 3, below, 
shows an example directory tree for the NoSuchCorpPkg. 
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WORKSPACE Directory 


+--- BaseTools 
+=—=iConk 
+--- NoSuchCorp Pkg 
i +---Bus 
ha PG 
+--- Peer BusDxe 


+---PciBusDxe 


i 
i} i} 

i} i} 

1 1 

i} i} 

' i 

' i +---  SuperDuperIO Dxe 

; +---Include 

i i +---Common 

+--- GUID 

! ! +---Library 

i i +---Protocol 

! +---Library 

! i +--- NoSu chHookStatusCodeLib 
' i +---SmmRuntimeDxeReportStatusCodeLib 
f +---Universal 

i +--- DualSegment CfgPei 

' +--- DualSegmentCfg Dxe 

! +---StatusCode 

i +---Dxe 

' +---Pei 


+--- MdePkg 
+--- MdeModulePkg 


FG 20003 


Figure 3 - 2. NoSuchCorpPkg Directory Tree 


A Distribution Package File may be created by the following steps: 


1. 


Determine the set of files that will be distributed, including packages, modules, tools, and 
miscellaneous content. 


Create the Distribution Description File, and complete the Distribution Header Information. 
For each package that will be included in the Distribution Content File, 


a If a supported "declaration" file, exists for the package, it can be used as a starting point 
- otherwise, the information will need to be filled in manually. 


b Specify any Library Classes, GUIDS, Protocols or PPIs that are declared by header files in 
the package. 


c List the reference names of the modules that are to be included in this package - every 
reference name provided in this list must have a corresponding module surface area 
section in this file. 


d Specify any PCDs that are declared within the package. Typically, these are defined in a 
specification that uniquely identifies the declared PCDs, i.e., a NoSuch Package 
Specification would define the PedTokenSpaceGuidCName: 
gEfiNoSuchPkgTokenSpaceGuid (the GUID is for this is declared in step b, above) and 
individual PCD information for each PCD in the spec. Each PCD must be declared in 
every PCD section type that it might be coded for, i.e., PedsFixedAtBuild, 
PcdsPatchableInModule and PedsDynamic. 


e Specify the location of any Include folders that are provided by this package. 


f Include all top level header files that are to be included in the Include folders. For example: 
"Include/Ppi/Cpulo.h" 
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g Add any other package files that are to be included and not listed in step e. Module 


information is handled separately, so do not include them here. Listing the supported 
declaration file is not required. Test "platform" files, used for testing a build of modules 
that are part of a package may be included for reference. 


h Add the package information to the Distribution Description File. 
4. For each module that will be included in the Distribution Content File, 


If a supported module description file exists for the module, it can be used as a starting 
point, otherwise, the information will need to be entered manually. 


Complete the Module header information. 


Include all the files referred to by the module description file. Add filenames to either the 
SourceFiles or BinaryFiles section as appropriate, using file paths that are relative to the 
root of the module. For example: "Ja32/CpuPause.asm" 

Include all files that are part of a module, but not listed in the module description file. 
Listing the module description file is not required. 


Add the module information to the Distribution Description File. 


5. For all tools that are going to be distributed, 


Complete the Tool section header information 


6. For anything not listed in steps 2, 3 or 4, 


Complete the MiscellaneousFiles section 


Complete a File entry for each file that will be included in the distribution not already 
entered. 


Complete any additional information for the MiscellaneousFiles section using freeform 
text or XML for the content. 


7. Create the Distribution Package File. 


Generate the Distribution Content File from the content. 


Compute the MD5 sum of the Distribution Content and update the Signature field in the 
Distribution Description File's header. 


Add the Distribution Description File and Distribution Content File to the Distribution 
Package File. 


3.8.1 Installing a Distribution Package File 


This section covers the general steps need to install a Distribution Package File on a developer's 
workstation. Tools may be required to have an a priori knowledge of the developer's development 
project space. 


1. The user may need to select a build meta data format for generating build specific meta-data. 


2. The tool need to generate a 'database' of content installed in the project space. 


3. For each package declaration section 


Test the dependencies for the declaration section - See Distribution Rules and Definitions, 
below. 


Specify an alternate installation location within the project space, if needed. 
Create the build specific package declaration files, if required. 
Extract any files within this section to the specified location. 


Update any distribution management "database" to point to a new location - only required 
if the default path was not used to extract the file(s.) 
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For each module information section, 


¢ Test the dependencies for the module section - See Distribution Rules and Definitions, 
below. 


¢ Specify an alternate installation location within the project space, if needed. 
¢ Create the build specific module description files, if required. 
¢ Extract any files within this section to the specified location. 


* Update any distribution management "database" to point to a new location - only required 
if the default path was not used to extract the file(s.) 


For a Tool section, 
¢ Specify an alternate installation location, if needed. 
¢ Extract any files within this section to the specified location. 


¢ Update any distribution management "database" to point to a new location - only required 
if the default path was not used to extract the file(s.) 


For a MiscellaneousFiles section, 
¢ Specify an alternate installation location, if needed. 
¢ Extract any files within this section to the specified location. 


¢ Update any distribution management "database" to point to a new location - only required 
if the default path was not used to extract the file(s.) 

Store the Distribution Description File in a directory as specified by any tools. 

¢ Ifan alternate name has been specified, store the file using the alternate name and .pkg 
extension in a directory as specified by any tools. 

¢ Ifno alternate name was provided, and if a Distribution Description File already exists, 
then rename the Distribution Description File filename with _<Distribution Package 
GUID> appended prior to the .pkg extension. If the name already exists, ask the user for 
an alternate name, and use that name instead. 


3.8.1 Removing a Distribution 


This function will remove the selected distribution package from the project directory. 


1. 


From distribution management "database", select the Distribution Description File that 
matches the Distribution Package File that will be removed. 


Test the Package against dependencies specified in all of the supported meta-data 
infrastructure files in the project. 


¢ If any build meta-data file requires this package, let the user know that meta-data files 
require this package, and give them an option to abort the removal. If they choose to 
continue to remove the package, print the list of meta-data files that depend on the 
package, and inform the user that a list of dependent meta-data files that are no longer 
valid is in a file. 


Remove all files specified in the Distribution Description File using the extracted information 
if the files were stored in an alternate location. 


3.9 Distribution Rules and Definitions 
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Definitions and rules for creating, installing, updating, and removing distributions within a project 
WORKSPACE. The terms GUID and PackageGuid in the rules below refer to the value of a 
GUID. The terms Version and PackageVersion in the rules below refer to a version value. 


Table 3 - 1. Distribution Rules & Definitions KEY 
Example Definitions 
A workspace 


A module 


A Distribution 


A package 


A location 
Other Distribution 


Other Package 


1. A module M is said to depend upon a package P, if and only if there exists a tuple 
(PackageGuid, PackageVersion) in the set M->PackageDependencies for which P- 
>GUID == PackageGuid, and if PackageVersion is not empty, then P->Version == 
PackageVersion. 

2. A distribution D is said to depend on a Distribution G, if and only if there is a module in a 
package in D that depends on a package in G. 

3. A distribution D is said to depend on a package P, if and only if there is a module M contained 
in D that depends on P. 

4. A distribution D may be installed into the WORKSPACE W, if and only if for each module M in 
D, M's dependencies are met by the packages in W. 
¢ Ifthe dependencies are not met, then no part of distribution D will be installed. It is not 

legal to partially install a distribution into the WORKSPACE. 

5. A distribution D may be removed from the WORKSPACE W, if and only if for each module M 
in WORKSPACE W, and for each package P in D, M does not depend on P. 
¢ If there is some dependency on D, then no part of D may be uninstalled from W. It is not 

legal to partially uninstall a distribution from the WORKSPACE. 

6. When installing a distribution D into WORKSPACE W, for each package P in D, allow the 
user to install in P's default location, or choose a new location L (which must be unoccupied) 
within the WORKSPACE. Record this location L in the database. Each package P in D will 
be recorded in the database, associated with the GUID of D, as well as the actual install 
location L. (So we will know which distribution each package belongs to.) 

7. When installing a distribution D into WORKSPACE W, if there exists a package P in W, and P 
is in D, then the user must be prompted to choose a location that does not collide with the 


location of P in WORKSPACE W. We will end up with two instances of P in W at two distinct 
locations. 
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A distribution D may replace a distribution G in the WORKSPACE W, if and only if for each 
module M contained in W, if M depends on a package P, and P is only contained in G, then there 
must exist a package Q in D, such that the dependency of M can be satisfied by Q. 


¢ The net effect is that G is removed and D is installed, in one operation. The normal rules 
for installing D still apply - the dependencies of the modules of D must be satisfied. After 
the replacement, it must be the case that all the modules' dependencies in the 
WORKSPACE are satisfied. 


¢ If we find that the replace operation is not permitted, then the user may install D and keep 
G. Next, the user may "port" to D every package P in G on which a module M in W 
depends. Once all the dependencies can be resolved without the packages in G the user 
can remove G. 

A special case of the above rule is that a distribution D may be reinstalled into the 

WORKSPACE. (This would allow the user to get a fresh copy, or change the location in the 

WORKSPACE where one or more of the packages of D are installed.) 


. When a distribution D is removed from the WORKSPACE W, for each package P in D, we 


will remove P from W. 


. Ifa package P belongs to a distribution D, then it is not legal to remove P from the 


WORKSPACE W unless D is removed from W. 


. A package P may be removed from the WORKSPACE, provided there does not exist a 


distribution D that contains P. (Newly created or cloned packages will not exist within a 
distribution, and thus may be removed from the WORKSPACE directly.) 

When a distribution D is removed from the WORKSPACE, remove all the files in D from the 
WORKSPACE tree. 


When a distribution is created, a GUID is generated and assigned to the distribution. If a 
distribution is created from the same components at a later time, it should have the same 
GUID. 


If a package P is marked with P->RePackage==false, then P may not be added toa 
distribution. 

A distribution D is identical to a distribution G, if and only if D->GUID == G->GUID and 
D->Version == G->Version. 

A distribution D may be installed into the WORKSPACE W, if and only if there is no 
distribution G in W such that D->GUID == G->GUID and D->Version == G- 
>Version. 
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Distribution Description XML Schema 


The Distribution Description XML Schema defines the contents of a distribution surface area 
including all associated meta-data. This chapter defines the XML Grammar that is used to 
describe the contents of the distribution package. This distribution surface area description data 


resides in the Distribution Description File. 

The XML Schema Namespace is http://www.uefi.org/2015/1.0. 

This and following chapters of the document describe the schema in detail. 
The XML Instance Representation for DistributionPackage is as follows: 


<?xml version="1.0"?> 


<DistributionPackage xmlns="http://www.uefi.org/2015/1.0" 
xmlns:xsi="http: /www.w3.org/2001/XMLSchema-instance" > 


<DistributionHeader> ... </DistributionHeader> {1} 
<PackageSurfaceArea> ... </PackageSurfaceArea> {0,} 
<ModuleSurfaceArea> ... </ModuleSurfaceArea> {0,} 
<Tools> ... </Tools> {0,} 

<MiscellaneousFiles> ... </MiscellaneousFiles> {0,} 
<UserExtensions> ... </UserExtensions> {0,} 


</DistributionPackage> 


Table 4 - 1. DistributionPackage 


Description This is the root element of the distribution XML schema. 


Required YES 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


4.1 DistributionPackage.DistributionHeader 


The following is the description of the DistributionPackage.DistributionHeader 


instance: 
<DistributionHeader 
ReadOnly=” xs:boolean “ {0,1} 
RePackage=” xs:boolean “ {0,1} > 
<BaseName> 
xs :Nmtoken 
</BaseName> {1} 
<Name 
Lang=""_ xs:language " {0,1} > 
xs:normalizedString 
</Name> {1} 
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<GUID 
Version=""xs:decimal " {1} > 
RegistryFormatGUID 


</GUID> {1} 
<Vendor> xs:normalizedString </Vendor> {1} 
<Date> xs:dateTime </Date> {1} 
<Copyright> xs:string </Copyright> {1} 
<License> xs:string </License> {1} 
<Abstract> 
Lang="_ xs:language " {0,1} > 
xs:normalizedString 
</Abstract> {1,} 
<Description 
Lang="_ xs:language " {0,1} > 
xs:string 
</Description> {0,} 
<Signature> Md5Sum </Signature> {0,1} 
<Xml1Specification> xs:decimal </XmlSpecification> {1} 
</DistributionHeader> 


Table 4 - 2. DistributionPackage.DistributionHeader 


This is the Header Meta data for the distribution. Most of the content is required by 
legal departments. 


Description 


Required YES 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


4.1.1 DistributionHeader:ReadOnly 
Table 4 - 3. DistributionHeader:ReadOnly 


Description If set to true, all content within this distribution archive should NOT be modified. 
Required NO 
Data Type Attribute — xs:boolean 


Data Constraints Either “true” or “false” (default) 


Examples ReadOnly=”true” 


4.1.2 DistributionHeader:RePackage 


Table 4 - 4. DistributionHeader:RePackage 
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If set to true, then the distribution and its content may be packaged into another 
distribution. 


Description 


Required NO 
Data Type Attribute — xs:boolean 


Data Constraints Either “true” or “false” (default) 


Examples RePackage=”" true” 


4.1.3 DistributionHeader.Name 
Table 4 - 5. DistributionHeader.Name 


Description The User Interface Name of the Distribution Package File. 
Required YES 
Data Type Element -— xs:normalizedString 


String value of one or more characters; limited to ASCII printable characters 


Data Constraint 
a ence between 0x20 and 0x’7f, inclusive. 


Examples <Name> ICH7 Chipset </Name> 


4.1.4 DistributionHeader.Name:BaseName 
Table 4 - 6. DistributionHeader.Name:BaseName 


The reference name of the Distribution Package File. This single word name can 
be used by tools as a keyword or for directory and/or file creation. 


Description 
Required NO 
Data Type Attribute — xs:Nmtoken 


Data Constraints String value of one or more characters. No white space characters are permitted. 


Name="P_ 882” 


E | 
cal anaes Name="MdePkg” 


4.1.4.1 Header.Name:Lang 
Table 4 - 7. Header.Name:Lang 


Description The language code uses an RFC 1766 language code identifier 


Required NO 


Data Type Attribute — xs:language 
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Data Constraints 


Examples 


If present, the language code must use an RFC 1766 language code identifier. If 
not specified, the default is “en-us.’ 


Lang="en-us” 
Lang="fra” 


4.1.5 DistributionHeader.GUID 


Table 4 - 8. DistributionHeader.GUID 


Description 


Required 
Data Type 


Data Constraints 


Examples 


The 128 bit Unique ID of the package. This is used to check if the distribution is 
already installed. This value must change if the entire distribution archive does not 
provide backward compatibility. 


YES 
Element — RegistryFormatGuid 
A string that represents a GUID in registry format. 


<GUID Version="1.2"> AFODDA2E-EA83-480b-B2CE- 
FCOBB2F894C2 </GUID> 


4.1.6 DistributionHeader.GUID:Version 


Table 4 - 9. DistributionHeader.GUID:Version 


Description 


Required 
Data Type 
Data Constraints 


Examples 


The version of the distribution. It is assumed that the version is used to give 
information to the user about the distribution, but the tools will use the version of 
the distribution to compare to the version of another distribution with the same 
GUID. If the distribution contains backward compatible content, then only this 
version number will change. The higher the number, the more recent the content. 


YES 
Attribute — xs:decimal 
A decimal value that must include the period character. 


Version="1.2” 


4.1.7 DistributionHeader.Vendor 


Table 4 - 10. DistributionHeader.Vendor 


Description 


Required 


Data Type 


A string identifying who created this distribution package. 
YES 


Element — xs:normalizedString 
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Data Constraints Any string 


Examples <Vendor> Nosuch Corporation </Vendor> 


4.1.8 DistributionHeader.Date 
Table 4 - 11. DistributionHeader.Date 


Description The date and time that this distribution was created. 
Required YES 
Data Type Element — xs:dateTime 


YYYY-MM-DDThh:mmiss[.uuuuu], the ‘T’ character is used to separate the date 


Data Constraints 
from the time, the microsecond entry is optional. 


<Date> 2008-01-01T13:30:44 </Date> 


examples <Date>2008-03-24T09: 30:00</Date> 


4.1.9 DistributionHeader.Copyright 
Table 4 - 12. DistributionHeader.Copyright 


The copyright for this file that is generated by the creator of the distribution. Ifa 
derivative work is generated from an existing distribution, then the existing 

Description copyright must be maintained, and additional copyrights may be appended to the 
end of this element. It may also be the primary copyright for all code provided in the 
distribution. 


Required YES 
Data Type Element — xs:string 
Data Constraints One or more lines of text. 


<Copyright> 

Copyright (c) 2008, Nosuch Corporation. All 
rights reserved. 

</Copyright> 


Examples 


4.1.10 DistributionHeader.License 
Table 4 - 13. DistributionHeader.License 


A license that describes any restrictions on the use of this distribution. Ifa 
derivative work is allowed by the original license and a derivative work is 
generated from an existing distribution, then the existing license must be 
maintained, and additional licenses may be appended to the end of this element. It 


Description 
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Required 


Data Type 


Data Constraints 


Examples 


may also be the primary license for all code provided in the Distribution Package 
File. Alternatively, this may point to a filename that contains the License. The file 
will be stored in the same location as the Distribution Description File. 


YES 
Element — xs:string 


Paragraph or file name. If the filename, then the file must have a file extension of 
either .txt or .lic, otherwise any number of lines of text. 


<License> 
This program and the accompanying materials are 


licensed and made available under the terms and 
conditions of the BSD License which accompanies 
this distribution. The full text of the license 
may be found at: 

http: //opensource.org/licenses/bsd-license.php 


THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE 
ON AN AS IS BASIS, WITHOUT WARRANTIES OR 
REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR 
IMPLIED. 
</License> 
<License> MyLicense.txt </License> 
<License> NoSuchLicense.lic </License> 


4.1.11 DistributionHeader.Abstract 


Table 4 - 14. DistributionHeader.Abstract 


Description 
Required 
Data Type 


Data Constraints 


Examples 


A one line description of the distribution. 
YES 
Element — xs:normalizedString 


N/A 


<Abstract> Version 1 of the NoSuchPkg package. 
</Abstract> 


4.1.11.1 DistributionHeader.Abstract:Lang 


Table 4 - 15. DistributionHeader.Abstract:Lang 


Description The language code uses an RFC 1766 language code identifier 
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Required NO 


Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
Bie Gens taints not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
nae Lang="fra” 


4.1.12 DistributionHeader.Description 
Table 4 - 16. DistributionHeader.Description 


A complete description of the distribution. This description may include the release 
name of the file, the version of the file, and a complete description of the file 
contents and/or features including a description of the updates since the previous 
file release. 


Description 


Required NO 
Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<Description> Initial release of the NoSuchPkg, 
Version 1.0 providing the base data types and 

Examples libraries for NoSuch UEFI Driver. This includes 
special libraries for reporting status codes of 
the driver. </Description> 


4.1.12.1 DistributionHeader.Description:Lang 
Table 4 - 17. DistributionHeader.Description:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Lang="en-us” 
Lang="fra” 


Examples 


4.1.13 DistributionHeader.Signature 


Table 4 - 18. DistributionHeader.Signature 
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Description 


Required 


Data Type 


Data Constraints 


Examples 


MD5sum of the Distribution Content File included in this Distribution Package File. 
NO 
Element — Md5Sum 


A 128-bit value, specified in hex format (32 characters.) A leading Ox is not 
permitted. 


<Signature> 09fa8fc7222da9afd9ffd52ba8b73£45 
</Signature> 


4.1.14 DistributionHeader.XmISpecification 


Table 4 - 19. DistributionHeader.XmISpecification 


Description 
Required 

Data Type 

Data Constraints 


Examples 


The XML Schema Specification to which this Distribution Description conforms. 
YES 
Element — xs:decimal 


Distribution Description XML Schema version. For this version, the value is 1.1. 


<Xml1Specification> 1.1 </XmlSpecification> 


oe 
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Chapter 5 - 
Package Surface Area Description 


This section describes the Package Surface Area section of the Distribution Description File. Zero or 
more of these sections are permitted within the Distribution Description File. 


The XML Instance Representation for DistributionPackage.PackageSurfaceArea 
is as follows: 
<PackageSurfaceArea> 
<Header> ... </Header> {1} 
<ClonedFrom> ... </ClonedFrom> {0,1} 
<LibraryClassDeclarations> ... </LibraryClassDeclarations> {0,1} 
<IndustryStandardIncludes> ... </IndustryStandardIncludes> {0,1} 
<PackageIncludes> ... </PackageIncludes> {0,1} 
<Modules> ... </Modules> {0,1} 
<GuidDeclarations> ... </GuidDeclarations> {0,1} 
<ProtocolDeclarations> ... </ProtocolDeclarations> {0,1} 
<PpiDeclarations> ... </PpiDeclarations> {0,1} 
<PcdDeclarations> ... </PcdDeclarations> {0,1} 
<PcdRelationshipChecks> ... </PcdRelationshipChecks> {0,1} 
<MiscellaneousFiles> ... </MiscellaneousFiles> {0,} 
<UserExtensions> ... </UserExtensions> {0,} 
</PackageSurfaceArea> 


Table 5 - 1. DistributionPackage.PackageSurfaceArea 


Description This element contains all the information associated with a Package Surface Area 
Required NO 
Data Type Element — Complex 


Data Constraints The Header element is required. All other elements are optional. 


Examples N/A 


5.1 PackageSurfaceArea.Header 


The following is the description of the PackageSurfaceArea . Header instance: 
<Header> 
<BaseName> 
xs :Nmtoken 
</BaseName> {1} 
<Name 
Lang=""_xs:language " {0,1} > 
xs:normalizedString 
</Name> {1} 


<GUID 
Version=”" xs:decimal “ {1} > 
RegistryFormatGuid 
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</GUID> {1} 
<Copyright> xs:string </Copyright> {0,1} 
<License> xs:string </License> {0,1} 
<Abstract 
Lang=""_ xs:language " {0,1} > 
xs:normalizedString </Abstract> {0,} 
<Description 
Lang="" xs:language " {0,1} > 
xs:string </Description> {0,} 
<PackagePath> xs:anyURI </PackagePath> {1} 
</Header> 


Table 5 - 2. PackageSurfaceArea. Header 
This element contains the header information for a Package Surface Area. This 


Description includes the name of the package, copyright and licensing information associated 
with the package. 

Required YES 

Data Type Element — Complex 

Data Constraints N/A 

Examples N/A 


5.1.1 Header.Name 


Table 5 - 3. Header.Name 


Description The User Interface Name for the package. 


Required YES 
Data Type Element — xs:normalizedString 
Data Constraints String value of one or more characters. 


<Name>MDE Package Version 1.00</Name> 


i <Name>NT32 Package Version 2.76</PackageName> 


5.1.2 Header.Name.BaseName 
Table 5 - 4. Header.Name:BaseName 


er The reference name of the package. This single word name can be used by tools 
Description ' ; 
as a keyword and for directory/file creation. 
Required YES 
Data Type Attribute — xs:Nmtoken 


Data Constraints String value of one or more characters. No white space characters are permitted. 


Name="P_ 882” 
Name="MdePkg” 


Examples 
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5.1.3 Header.GUID 
Table 5 - 5. Header.GUID 
The 128-bit GUID VALUE that is the unique name of a package. This value must 


Description change any time a release of the package does not provide full backward 
compatibility. 


Required YES 


Data Type Element — RegistryFormatGuid 


A string that represents a GUID in registry format. 

Ifa package is backwards compatible with a previous release of the same 
package, then PackageSurfaceArea .Header . GUID element must not 
be changed, and only the 

PackageSurfaceArea.Header .GUID: Version attribute should be 
increased. If a package is not backward compatible with a previous release ora 
new package is being created, then a new 

PackageSurfaceArea .Header . GUID must be generated. 


Data Constraints 


<GUID> AFODDA2E-EA83-480b-B2CE-FCOBB2F894C2 


E | 
ounces </GUID> 


5.1.4 Header.GUID:Version 
Table 5 - 6. Header.GUID:Version 


The version of this package. The version number must change (incrementally) for 
every release of a package. Since itis tied to the package GUID, this value may be 
reset to an initial number, if the GUID changes due to a non-backward compatible 
release. 


Description 


Required YES 
Data Type Attribute — xs:decimal 
Data Constraints A string that contains a decimal number with a dot separator. 


Version="1.00” 
Examples Version="1.02” 
Version="3.27” 


5.1.5 Header.Copyright 
Table 5 - 7. Header.Copyright 


The copyright for this package if it is different than the copyright of the distribution 


Description package. The copyright is generated by the creator of a package. Ifa derivative 
work is generated from an existing package, then the existing copyright must be 
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maintained, and additional copyrights may be appended to the end of this element. 


Required NO 
Data Type Element — xs:string 
Data Constraints A set of one or more copyright statements on one or more lines of text. 


<Copyright> Copyright (c) 2006, Nosuch 


Examples Corporation. All rights reserved. </Copyright> 


5.1.6 Header.License 
Table 5 - 8. Header.License 


A license that describes any restrictions on the use of this package. If a derivative 
work is allowed by the original license and a derivative work is generated from an 

Description existing package, then the existing license must be maintained, and additional 
licenses may be appended to the end of this element. Alternatively, this may point 
to a file that will be in the same folder as the package declaration file. 


Required NO 
Data Type Element — xs:string 


A string that contains one or more lines of text. If a file, then the file must be an 


Bae Lonetains ASCII text file with either a txt or .lic extension. 


<License> 

This program and the accompanying materials are 
licensed and made available under the terms and 
conditions of the BSD 

License which accompanies this distribution. The 
full text of the license may be found at 


Ecempies http: //opensource.org/licenses/bsd-license. php 


THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE 
ON AN AS IS BASIS, WITHOUT WARRANTIES OR 
REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR 
IMPLIED. 
</License> 
<License> License.txt </License> 


5.1.7 Header.Abstract 


Table 5 - 9. Header.Abstract 


Description A one line description of this package if different from the distribution’s abstract. 
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Required NO 


Data Type Element -— xs:normalizedString 


Data Constraints N/A 


<Abstract>Headers for NoSuch Development 


Examples 
P Environment Core (MDE.)</Abstract> 


5.1.7.1 Header.Abstract:Lang 
Table 5 - 10. Header.Abstract:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints . ‘ 
not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
ee Lang="fra” 


5.1.8 Header.Description 
Table 5 - 11. Header.Description 


A complete description of a package. This description may include the release 
name of the package, the version of the package, and a complete description of 
the package contents and/or features including a description of the updates since 
the previous package’s release. 


Description 


Required NO 
Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<Description> NoSuch Package Version 0.75 that 
conforms to the NoSuch Package Specification 
Version 0.75. This package contains all the 
include files, Protocols, PPIs, GUIDs, Library 

Examples Classes, and Library instances required to build 
modules that are compliant with the UEFI/PI 
Specifications. This package was updated from 
Version 0.74 and now includes addition Base 
Library String Functions. </Description> 
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5.1.8.1 Header.Description:Lang 
Table 5 - 12. Header.Description:Lang 


Description The language code uses an RFC 1766 language code identifier 


Required NO 


Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
ale Consens not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
a Lang="fra” 


5.1.9 Header.PackagePath 
Table 5 - 13. Header.PackagePath 


— This is the location (in the Distribution Content File) for the root directory ofa 
Description 
package. 
Required YES 
Data Type Element -— xs:anyURI 


Data Constraints A directory location (in the Distribution Content File.) 


Examples <PackagePath> NoSuchPkg </PackagePath> 


5.2 PackageSurfaceArea.ClonedFrom 


This section is used to track a package that was cloned (copied from) an existing package. 


The following is the description of the PackageSurfaceArea .ClonedFron instance: 
<ClonedFrom> 
<GUID 
Version="xs:decimal " {1} > 
RegistryFormatGuid 
</GUID> {1} 
</ClonedFrom> 


Table 5 - 14. PackageSurfaceArea.ClonedFrom 


If the package sources were copied from an existing package, then this Section 


Description 
i can be used to track the lineage. 


Required NO 


Data Type Element — Complex 
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Data Constraints N/A 


Examples N/A 


5.2.1 ClonedFrom.GUID 
Table 5 - 15. ClonedFrom.GUID 


If the package sources were copied from an existing package, this is the GUID of 
the package that was the source of the copy. 


Description 
Required YES 

Data Type Element — RegistryFormatGuid 

Data Constraints Registry format GUID of the pre-existing package 


<GUID Version="1.0”> 27d67720-ea68-48ae-93da- 


Examples a3a074c90e30 </GUID> 


5.2.2 ClonedFrom.GUID:Version 
Table 5 - 16. ClonedFrom.GUID:Version 


nae If the package sources were copied from an existing package, this is the version of 
Description 
the package that was the source of the copy. 
Required YES 
Data Type Attribute — xs:decimal 


Data Constraints Version number of the pre-existing package 


Examples Version="1.0” 


5.3 PackageSurfaceArea.LibraryClassDeclarations 


This section provides the mapping of Library Class keywords to the header files that define the 
interfaces and data structures that a library class requires. All Library Class declarations must be 
unique to the package. 


The following is the description of the 
PackageSurfaceArea.LibraryClassDeclarations instance: 
<LibraryClassDeclarations> 
<LibraryClass 
Keyword=""xs:NCName " {1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} > 
<HeaderFile> xs:anyURI </HeaderFile> {1} 
<RecommendedInstance> 
<GUID 
Version="_xs:decimal " {0,1} > 
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RegistryFormatGuid 
</GUID> {1} 
</RecommendedInstance> {0,1} 
<HelpText 
Lang="" xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</LibraryClass> {1,} 
</LibraryClassDeclarations> 


Table 5 - 17. PackageSurfaceArea.LibraryClassDeclarations 


Description The list of library classes that the package declares. 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


5.3.1 LibraryClassDeclarations.LibraryClass 
Table 5 - 18. LibraryClassDeclarations.LibraryClass 


Description The individual Library Class declared — a keyword and a header file. 
Required YES 

Data Type Element — Complex 

Data Constraints N/A 


Examples N/A 


5.3.2 LibraryClassDeclarations.LibraryClass:Keyword 
Table 5 - 19. LibraryClassDeclarations.LibraryClass:Keyword 


Description Modules may be coded to use a library class header identified by this keyword. 
Required YES 
Data Type Attribute — xs:NCName 


A string that start with a letter or an underscore and is followed by any combination 


Data Constraint 
pbc mens of letters, digits, periods, hyphens, and underscores. No whitespace is allowed. 


Keyword="BaseLib” 
Keyword=”"PrintLib” 


Examples 
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5.3.3 LibraryClassDeclarations.LibraryClass:SupArchList 
Table 5 - 20. LibraryClassDeclarations.LibraryC lass:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this Library 
Class. If this attribute is not specified, then this Library Class may be used with any 

Description CPU Architecture. If this attribute is specified, then only those modules that support 
a subset of the CPU architectures specified by this element may use this Library 
Class. 


Required NO 


Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList="IA32” 
Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


5.3.4 LibraryClassDeclarations.LibraryClass:SupModList 
Table 5 - 21. LibraryClassDeclarations.LibraryClass:SupModList 


Used to restrict the set of module types that are allowed to use this Library Class. If 
this attribute is not specified, then this Library Class may be used with all module 

Description types. If this attribute is specified, then only those modules that have a module type 
that is a member of the set of module types specified by this element may use this 
Library Class. 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, UEFI_DRIVER, UEFI_RUNTIME _ 
DRIVER, UEFI_APPLICATION, USER_DEFINED, SMM CORE. 


SupModList=”BASE” 

SupModList=”PEIM DXE_DRIVER” 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER” 


Examples 


5.3.5 LibraryClassDeclarations.LibraryClass.HeaderFile 


Table 5 - 22. LibraryClassDeclarations.LibraryC lass.HeaderFile 


Descriptio | This is elementis a single header file that defines the library class calling conventions and 
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n format. 


Required YES 


Data Type | Element-— xs:anyURI 


Data 
Constraint 
s 


The PackagePath relative path and filename in the Distribution Content Content File for the 
include file associated with the Library Class. 


<HeaderFile>Include/Library/PeiServicesLib.h</HeaderFil 
Examples | e> 
<HeaderFile> Include/Library/HobLib.h </HeaderFile> 


5.3.6 LibraryClassDeclarations.LibraryClass.Recommendedinstance 
Table 5 - 23. LibraryClassDeclarations.LibraryClass.RecommendedInstance 


exits The recommended library instance as defined by the creator of the Library Class 
Description 
Header file. 
Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


5.3.7 
LibraryClassDeclarations.LibraryClass.Recommendedinstance.G 
UID 


Table 5 - 24. LibraryClassDeclarations.LibraryC lass.RecommendedInstance.GUID 


The GUID of the recommended library instance as defined by the creator of the 
Library Class Header file. This is a required element. If GUID is specified, and the 
Version attribute is not, then the algorithm to look up the recommended instance is 
to find the library instance highest version number and a matching GUID. 


Description 


Required YES 
Data Type Element — RegistryFormatGuid 


A string that represents a GUID in registry format. Not valid if no Recommendedinf 


Dat traint 
ele Conetalhts attribute specified. 


Examples <GUID>AFODDA2E-EA83-480b-B2CE-FCOBB2F894C2</GUID> 
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5.3.8 
LibraryClassDeclarations.LibraryClass.Recommendedinstance.G 
UID:Version 


Table 5 - 25. LibraryClassDeclarations.LibraryC lass:RecommendedInstance.GUID:Version 


The version of the recommended library instance as defined by the creator of the 
Description Library Class Header file. If this attribute is not specified, then the recommended 
library instance is the highest version number with a matching GUID. 


Required NO 
Data Type Attribute — xs:decimal 
Data Constraints Unsigned decimal number. 


Version="1.0” 


exemple Version="2.75” 


5.3.9 LibraryClassDeclarations.LibraryClass.HelpText 
Table 5 - 26. LibraryClassDeclarations.LibraryC lass.HelpText 


Description A paragraph describing this library class, including usage models and restrictions. 
Required NO 

Data Type Element — xs:string 

Data Constraints A string that contains one or more lines of text. 


<HelpText> This is the include file for any 
module of type BASE. Base modules only use types 
defined via this include file and can be ported 
easily to any environment. There are a set of 
base libraries in the NoSuch Package that can be 
used to implement base modules. </HelpText> 


Examples 


5.3.10 LibraryClassDeclarations.LibraryClass.HelpText:Lang 
Table 5 - 27. LibraryClassDeclarations.LibraryC lass.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
aie Consens not specified, the default is “en-us.’ 


Examples Lang="en-us” 
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5.4 PackageSurfaceArea.IndustryStandardincludes 


The following is the description of the 
PackageSurfaceArea.IndustryStandardIncludes instance: 
<IndustryStandardIncludes> 
<IndustryStandardHeader> 
<HeaderFile> xs:anyURI </HeaderFile> {1} 
<HelpText 
Lang=""_xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</IndustryStandardHeader> {1,} 
</IndustryStandardIncludes> 


Table 5 - 28. PackageSurfaceArea.IndustryStandardIncludes 


Description This section contains a list of industry standard header files. 


Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


5.4.1 IndustryStandardincludes.IndustryStandardHeader 
Table 5 - 29. IndustryStandardIncludes.|IndustryStandardHeader 


Description This is elementis a single industry standard header . 
Required YES 
Data Type Element — Complex 


Data Constraints Must contain one and only one Header File 


Examples N/A 


5.4.2 IndustryStandardincludes.IndustryStandardHeader.HeaderFile 


Table 5 - 30. IndustryStandardIncludes.|IndustryStandardHeader. HeaderFile 


Description 
P modules. 


Required YES 


Data Type | Element-— xs:anyURI 


This is elementis a single industry standard header file that maybe used by multiple 


Data A package relative path and filename (as located in the Distribution Content File) for the 
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Constraints | include file associated with the Industry standard header file. 


<HeaderFile>Include/IndustryStandard/Pci.h</HeaderFil 
e> 

<HeaderFile> Include/IndustryStandard/Acpi.h 
</HeaderFile> 


Examples 


5.4.3 IndustryStandardincludes.IndustryStandardHeader.HelpText 
Table 5 - 31. IndustryStandardIncludes.IndustryStandardHeader. HelpText 


Description A paragraph describing this header file, including usage models and restrictions. 
Required NO 

Data Type Element — xs:string 

Data Constraints A string that contains one or more lines of text. 


<HelpText USC2="false” Lang="en-us”> This file 
contains the latest ACPI definitions that are 
consumed by drivers that do not care about ACPI 
versions .</HelpText> 


Examples 


5.4.4 IndustryStandardincludes.industryStandardHeader.HelpText:Lang 
Table 5 - 32. IndustryStandardIncludes.IndustryStandardHeader. HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


5.5 PackageSurfaceArea.Packagelncludes 


This section is used to list include paths and header files that are a subset of other header files 
specified for either GUIDs, Protocols and/or PPIs or for supporting a given module type. 


The following is the description of the PackageSurfaceArea . PackageIncludes 
instance: 


<PackageIncludes> 
<PackageHeader> 
<HeaderFile 
SupArchList=" ArchListType " {0,1} 
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SupModList=" ModuleListType " {0,1} > 
xs:anyURI 
</HeaderFile> {1} 
<HelpText 
Lang=""_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</PackageHeader> {1,} 
</PackageIncludes> 


Table 5 - 33. PackageSurfaceArea.Packagelncludes 


Specifies the package relative include path or a package relative filename of an 
Description include file that extends the set of definitions available for the standard module 


types. 


Required NO 


Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


5.5.1 Packagelncludes.PackageHeader 
Table 5 - 34. Packagelncludes. PackageHeader 


Specifies the package relative include path or a package relative filename of an 
Description include file that extends the set of definitions available for the standard module 


types. 
Required YES 


Data Type Element — Complex 


Do not list: headers that are local to a module (module specific,) industry standard 


Data Constraints 
G headers or a library class header in this section. 


Examples N/A 


5.5.2 Packagelncludes.PackageHeader.HeaderFile 
Table 5 - 35. Packagelncludes. PackageHeader. HeaderFile 


Specifies the package relative include path or a package relative filename of an 
Description include file that extends the set of definitions available for the standard module 


types. 
Required YES 


Data Type Element — xs:anyURI 
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A PackagePath relative Path or a PackagePath relative Path and Filename (as 
located in the Distribution Content File.) 


Data Constraints 


<HeaderFile>Include</HeaderFile> 
Examples <HeaderFile>Include/Peim.h</HeaderFile> 
<HeaderFile> Include/EdkDxeCore.h </HeaderFile> 


5.5.3 Packagelncludes.PackageHeader.HeaderFile:SupArchList 
Table 5 - 36. Packagelncludes. PackageHeader. HeaderFile:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this header. If 
this attribute is not specified, then this header may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use header. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList="IA32” 
Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


5.5.4 Packagelncludes.PackageHeader.HeaderFile:SupModList 
Table 5 - 37. Packagelncludes. PackageHeader. HeaderFile:SupModList 


Used to restrict the set of module types that are allowed to use this header. If this 
attribute is not specified, then this header may be used with all module types. If this 
attribute is specified, then only those modules that have a module type thatis a 
member of the set of module types specified by this element may use this header. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


A string that contains a list of one or more module types. Module types are 
restricted to one of BASE, SEC, PE I_CORE, PEIM, DXE_CORE, DXE_ 

Data Constraints DRIVER, DXE_RUNTIME DRIVER, DXE_SAL DRIVER, DXE_SMM _ 
DRIVER, UEFI_DRIVER, UEFI_RUNTIME DRIVER, UEFI_ 
APPLICATION, USER_DEFINED,SMM CORE. 


SupModList=”BASE” 
Examples SupModList=”"PEI_ CORE PEIM” 
ModuleType="DXE_ CORE UEFI_DRIVER DXE_ DRIVER” 


5.5.5 Packagelncludes.PackageHeader.HelpText 
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Table 5 - 38. Packagelncludes. PackageHeader. HelpText 


Description A paragraph describing this header file, including usage models and restrictions. 


Required NO 
Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText USC2="false” Lang="en-us”> This file 
contains the latest ACPI definitions that are 
consumed by drivers that do not care about ACPI 
versions .</HelpText> 


Examples 


5.5.6 Packagelncludes.PackageHeader.HelpText:Lang 
Table 5 - 39. Packagelncludes. PackageHeader.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


5.6 PackageSurfaceArea.Modules 


This section is used to reference individual modules that are part of a package. 


The following is the description of the PackageSurfaceArea .Modules instance: 
<Modules> 
<ModuleSurfaceArea> ... </ModuleSurfaceArea> {1,} 
</Modules> 


Table 5 - 40. PackageSurfaceArea.Modules 


This is section may be used to include a list of modules that are part of this 
Description package. An module listed here must have a corresponding ModuleSurfaceArea 
section completed. 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


5.6.1 Modules.ModuleSurfaceArea 
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Refer to chapter 6, Module Surface Area Description. Modules that are part of a package should 
be listed here. Stand-alone modules that are not part of any package should be listed under the top 
level ModuleSurfaceArea section of the DistributionPackage. 


5.7 PackageSurfaceArea.GuidDeclarations 


This section defines all non-Protocol and non-Ppi C names and GUID values declared by a 
package. It is only specified in the package that declares the GUID in the design document. 


The following is the description of the PackageSurfaceArea.GuidDeclarations 
instance: 


<GuidDeclarations> 
<Entry 
UiName=" xs:normalizedString " {0,1} 
GuidTypes="" GuidListType " {0,1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} > 
<CName> xs:NCName </CName> {1} 
<GuidValue> RegistryFormatGuid </GuidValue> {1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
<LimitCount 
GuidType="" GuidListType " {1} > 
xs: number 
</LimitCount> {0,} 
</Entry> {1,} 
</GuidDeclarations> 


Table 5 - 41. PackageSurfaceArea.GuidDeclarations 


Description Specifies the list of GUIDs declared by this Package 


Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


5.7.1 GuidDeclarations.Entry 
Table 5 - 42. GuidDeclarations.Entry 


Specifies the individual GUID information for a GUID that is declared by a 
specification for this Package 


Description 
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Required YES 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


5.7.2 GuidDeclarations.Entry:UiName 
Table 5 - 43. GuidDeclarations.Entry:UiName 


Description A user interface name for this GUID entry. 
Required NO 
Data Type Attribute — xs:normalizedString 


A string that start with a letter or an underscore and is followed by any combination 


Data Constraints 
of letters, digits, periods, hyphens, and underscores. No whitespace is allowed. 


Examples UiName=”"CustomDecompress” 


5.7.3 GuidDeclarations.Entry:GuidTypes 
Table 5 - 44. GuidDeclarations.Entry:GuidTypes 


Used to restrict the set of GUID types that apply to this GUID. If this attribute is not 
specified, then this GUID may be used with all GUID types. If this attribute is 
specified, then this GUID may only appear in the sections of the module’s 
information (build implementation specific) file that have a matching GUID type. 


Description 


Required NO 
Data Type Attribute — GuidListType 


A string that contains one or more GUID types separated by spaces. The GUID 
Data Constraints types are restrictedtoEvent, File, FV, HII, HOB, SystemTable, 
TokenSpaceGuid, Variable orGUID (default.) 


GuidTypes=”TokenSpaceGuid” 
Examples GuidTypes="SystemTable” 
GuidTypes=”"”HOB SystemTable” 


5.7.4 GuidDeclarations.Entry:SupArchList 


Table 5 - 45. GuidDeclarations.Entry:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this GUID. If this 


Desciplon attribute is not specified, then this GUID may be used with any CPU Architecture. If 
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this attribute is specified, then only those modules that support a subset of the CPU 
architectures specified by this element may use this GUID. 


Required NO 

Data Type Attribute — ArchListType 

Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 
SupArchList=‘“IA32” 

Examples SupArchList=“IA32 X64” 


SupArchList=“EBC IPF X64” 


5.7.5 GuidDeclarations.Entry:SupModList 
Table 5 - 46. GuidDeclarations.Entry:SupModList 


Used to restrict the set of module types that are allowed to use this GUID. If this 
attribute is not specified, then this GUID may be used with all module types. If this 
attribute is specified, then only those modules that have a module type thatis a 
member of the set of module types specified by this element may use this GUID. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL _ 
DRIVER, DXE_SMM DRIVER, UEFI_DRIVER, UEFI_RUNTIME _ 
DRIVER, UEFI_APPLICATION, USER_DEFINED, SMM CORE. 


SupModList=“BASE” 

SupModList=“PEIM DXE_DRIVER” 
SupModList=“UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER” 


Examples 


5.7.6 GuidDeclarations.Entry.CName 
Table 5 - 47. GuidDeclarations.Entry.CName 


Description Specifies the symbol name for a GUID used in C code. 
Required YES 
Data Type Element — xs:NCName 


A valid C variable name string that starts with either an underscore or a letter, 


Data Constraints i 
followed by any number of letters, digits or underscores. 


<CName>Acpil0Table</CName> 
Examples <CName>PcAnsi</CName> 
<CName>DxeServicesTable</CName> 
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5.7.7 GuidDeclarations.Entry.GuidValue 


Table 5 - 48. GuidDeclarations.Entry.GuidValue 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Specifies the registry format value of the GUID. 
YES 

Element — RegistryFormatGuid 

A registry format GUID. 


<GuidValue> 8BE4DF61-93CA-11D2-AA0D-00E098032B8C 
</GuidValue> 

<GuidValue>DFA66065-B419-11D3-9A2D- 
0090273FC14D</GuidValue> 


5.7.8 GuidDeclarations.Entry.HelpText 


Table 5 - 49. GuidDeclarations.Entry.HelpText 


Description 


Required 
Data Type 


Data Constraints 


Examples 


A complete description of a GUID. This must include any defines and data 
structures associated with this GUID. It must also describe any use restrictions 
based on GUID Type, Module Type, CPU Architecture, and/or Feature Flags. 


NO 
Element — xs:string 
A string that contains one or more lines of text. 


<HelpText Lang="en-us”>The Console In Device GUID 
is used to tag an EFI_HANDLE for a Console Input 
Device as an active console input device. This is 
used by the Console Splitter Driver to search for 
set of console input devices in the handle 
database that should be multiplexed. This GUID is 
available to all CPU types, but is restricted for 
use by DXE_ DRIVER, UEFI_DRIVER, and UEFI_ 
APPLICATION module types .</HelpText> 


5.7.9 GuidDeclarations.Entry.HelpText:Lang 


Table 5 - 50. GuidDeclarations.Entry.HelpText:Lang 


Description 


Required 


Data Type 


The language code uses an RFC 1766 language code identifier 
NO 


Attribute — xs:language 
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If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


5.7.10 GuidDeclarations.Entry.LimitCount 


Table 5 - 51. GuidDeclarations.Entry. LimitCount 


Description a limit on the number of times a GUID of a given type may be installed if 
one exists 


Description 
Required NO 
Data Type Element — xs:Number 


Data Constraints A number 


<LimitCount GuidType “Event”> 1 </LimitCount> 
Examples <LimitCount GuidType = “TokenSpaceGuid”> 0x01 
</LimitCount> 


5.7.11 GuidDeclarations.Entry.LimitCount:GuidType 
Table 5 - 52. GuidDeclarations.Entry.LimitC ount:GuidType 


Description This element specifies the type of GUID. 
Required YES 


Data Type Attribute — GuidListType 


One or more of the enumerated values: Event, File, FV, GUID, HII, 
HOB, SystemTable, TokenSpaceGuid, or Variable 


Data Constraints 


UNDEFINED- implies that a GUID is used, but the package creator 
does not know the GUID's type 


GuidType= "Event"GuidType= 
"TokenSpaceGuid" SupModList="BASE" 

Examples SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE__ 
DRIVER" 


5.8 PackageSurfaceArea.ProtocolDeclarations 


This section defines all Protocol and ProtocolNotify C names and the GUID values declared by a 
package. It is only specified in the package that declares the Protocol in the design document. 
The following is the description of the PackageSurfaceArea. ProtocolDeclarations 


instance: 
<ProtocolDeclarations> 
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<Entry 
UiName=" xs:normalizedString " {0,1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
LimitCount=" Limit " {0,1} > 
<CName> xs:NCName </CName> {1} 
<GuidValue> RegistryFormatGuid </GuidValue> {1} 
<HelpText 
Lang=""_xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</Entry> {1,} 
</ProtocolDeclarations> 


Table 5 - 53. PackageSurfaceArea.ProtocolDeclarations 


Description Specifies the list of protocols that are declared by this package. 


Required NO 


Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


5.8.1 ProtocolDeclaration.Entry 
Table 5 - 54. ProtocolDeclarations.Entry 


Specifies the individual Protocol information about the protocol that must be 
declared by this package. 


Description 
Required YES 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


5.8.2 ProtocolDeclarations.Entry:UiName 
Table 5 - 55. ProtocolDeclarations.Entry:UiName 


Description A user interface name for this Protocol entry. 


Required NO 


Data Type Attribute — xs:normalizedString 


Data Constraints A string that start with a letter or an underscore and is followed by any combination 
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of letters, digits, periods, hyphens, and underscores. No whitespace is allowed. 


UiName="TIsaAcpi” 


E | . : 
a UiName=" PciHotPlugRequest” 


5.8.3 ProtocolDeclarations.Entry:SupArchList 
Table 5 - 56. ProtocolDeclarations.Entry:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this Protocol. If 
this attribute is not specified, then this Protocol may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that support a 
subset of the CPU architectures specified by this element may use this Protocol. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=“IA32” 
Examples SupArchList=“IA32 X64” 
SupArchList=“EBC IPF X64” 


5.8.4 ProtocolDeclarations.Entry:SupModList 
Table 5 - 57. ProtocolDeclarations.Entry:SupModList 


Used to restrict the set of module types that are allowed to use this Protocol. If this 
attribute is not specified, then this Protocol may be used with all module types. If 
this attribute is specified, then only those modules that have a module type thatis a 
member of the set of module types specified by this element may use this Protocol. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 


spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL _ 

DRIVER, DXE_SMM DRIVER, UEFI_DRIVER, UEFI_RUNTIME _ 

DRIVER, UEFI_APPLICATION, USER_DEFINED, SMM CORE. 


SupModList=“BASE” 

SupModList=“PEIM DXE_DRIVER” 
SupModList=“UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER” 


Examples 


5.8.5 ProtocolDeclarations.Entry:LimitCount 


Table 5 - 58. ProtocolDeclarations.Entry:LimitC ount 
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Description 
Required 
Data Type 


Data Constraints 


Examples 


The limit on the number of times this Protocol may be installed.. 


NO 
Attribute — Number 
A number (decimal or hex with preceding ‘Ox’). 


LimitCount =”"1” 
LimitCount =”0x1” 


5.8.6 ProtocolDeclarations.Entry.CName 


Table 5 - 59. ProtocolDeclarations.Entry.CName 


Description 
Required 


Data Type 


Data Constraints 


Examples 


Specifies the symbol name for a Protocol GUID used in C code. 
YES 
Element — xs:NCName 


A string that starts with either an underscore or a letter, followed by any number of 
letters, digits or underscores. 


<CName>gEfiBlockIoProtocolGuid</CName> 
<CName> gEfiDiskIoProtocolGuid </CName> 


5.8.7 ProtocolDeclarations.Entry.GuidValue 


Table 5 - 60. ProtocolDeclarations. Entry.GuidValue 


Description 
Required 
Data Type 


Data Constraints 


Examples 


Specifies the GUID value for a Protocol. 
YES 

Element — RegistryFormatGuid 

The Registry Format GUID Value 


<GuidValue> AFODDA2E-EA83-480b-B2CE-FCOBB2F894C2 
</GuidValue> 


5.8.8 ProtocolDeclarations.Entry.HelpText 


Table 5 - 61. ProtocolDeclarations.Entry.HelpText 


Description 


Required 


A complete description of a Protocol. This must include any functions, defines, and 
data structures associated with this Protocol. It must also describe any use 


restrictions based on Module Type, CPU Architecture, and/or Feature Flags. 


NO 
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Data Type Element — xs:string 


Data Constraints A string that contains one or more lines of text. 


<HelpText>The Block I/O Protocol provides services 


to read, write, and flush block to a block 
oriented storage device such as a hard disk, CD- 

Examples ROM, DVD, and floppy. This Protocol is available 
to all CPU types, but is restricted for use by 
DXE_DRIVER, UEFI_DRIVER, and UEFI_APPLICATION 
module types.</HelpText> 


5.8.9 ProtocolDeclarations.Entry.HelpText:Lang 
Table 5 - 62. ProtocolDeclarations.Entry.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints ; F 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


5.9 PackageSurfaceArea.PpiDeclarations 


This section defines all Ppi and PpiNotify C names and the GUID values declared by a package. It 
is only specified in the package that declares the Ppi in the design document. 


The following is the description of the PackageSurfaceArea.PpiDeclarations 
instance: 


<PpiDeclarations> 
<Entry 
UiName=" xs:normalizedString " {0,1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
LimitCount=" Limit " {0,1} > 
<CName> xs:NCName </CName> {1} 
<GuidValue> RegistryFormatGuid </GuidValue> {1} 
<HelpText 
Lang=""_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</Entry> {1,} 
</PpiDeclarations> 


Table 5 - 63. PackageSurfaceArea.P piDeclarations 
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Description Specifies a list of PPls that are declared by this Package. 


Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


5.9.1 PpiDeclarations.Entry 
Table 5 - 64. PpiDeclarations.Entry 


Description Specifies a single PPI that are declared by this Package. 
Required YES 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


5.9.2 PpiDeclarations.Entry:UiName 
Table 5 - 65. PpiDeclarations.Entry:UiName 


Description A user interface name for this PPI entry. 
Required NO 
Data Type Attribute — xs:normalizedString 


A string that start with a letter or an underscore and is followed by any combination 


Data Constraint 
ra nen of letters, digits, periods, hyphens, and underscores. No whitespace is allowed. 


UiName="BaseMemoryTest” 


Examples : 
UiName="OperatorPresence” 


5.9.3 PpiDeclarations.Entry:SupArchList 
Table 5 - 66. PpiDeclarations.Entry:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this PPI. If this 
attribute is not specified, then this PPI may be used with any CPU Architecture. If 


D ipti 
i ci this attribute is specified, then only those modules that support a subset of the CPU 


architectures specified by this element may use this PPI. 


Required NO 
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Data Type Attribute — ArchListType 


Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=“IA32” 
Examples SupArchList=“IA32 X64” 
SupArchList=“EBC IPF X64” 


5.9.4 PpiDeclarations.Entry:SupModList 
Table 5 - 67. PpiDeclarations.Entry:SupModList 


Used to restrict the set of module types that are allowed to use this PPI. If this 
attribute is not specified, then this PPI may be used with all module types. If this 
attribute is specified, then only those modules that have a module type thatis a 
member of the set of module types specified by this element may use this PPI. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL _ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED, SMM _ 
CORE. 


Data Constraints 


SupModList=“BASE” 

SupModList=“PEIM DXE_DRIVER” 
SupModList=“UEFI_DRIVER UEFI_APPLICATION DXE__ 
DRIVER” 


Examples 


5.9.5 PpiDeclarations.Entry:LimitCount 
Table 5 - 68. PpiDeclarations.Entry:LimitC ount 


Description The limit on the number of times this Protocol may be installed. 
Required NO 


Data Type Attribute — Number 


Data Constraints A number (decimal or hex with preceding ‘Ox’). 


LimitCount =”"1” 


Examples LimitCount =”0x1” 


5.9.6 


5.9.7 PpiDeclarations.Entry.CName 
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Table 5 - 69. PpiDeclarations.Entry.CName 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Specifies the symbol name for a PPI GUID used in C code. 
YES 
Element — xs:NCName 


A string that starts with either an underscore or a letter, followed by any number of 
letters, digits or underscores. 


<CName>gEfiDxeiIp1PpiGuid</CName> 
<CName> gEfiPciCfgPpiGuid </CName> 


5.9.8 PpiDeclarations.Entry.GuidValue 


Table 5 - 70. PpiDeclarations.Entry.GuidValue 


Description 
Required 
Data Type 


Data Constraints 


Examples 


Specifies the GUID value for a PPI. 
YES 

Element — RegistryFormatGuid 
The Registry Format GUID value. 


<GuidValue> AFODDA2E-EA83-480b-B2CE-FCOBB2F894C2 
</GuidValue> 


5.9.9 PpiDeclarations.Entry.HelpText 


Table 5 - 71. PpiDeclarations.Entry.HelpText 


Description 


Required 
Data Type 


Data Constraints 


Examples 


A complete description of a PPI. This must include any functions, defines, and data 
structures associated with this PPI. It must also describe any use restrictions based 
on Module Type, CPU Architecture, and/or Feature Flags. 


NO 
Element — xs:string 


A string that contains one or more lines of text. 


<HelpText>The PCI CFG PPI provides services to 
access PCI Configuration Headers from a PEIM. 
This PPI is available to all CPU types, but is 
restricted for use by PEIM module 

types .</HelpText> 


5.9.10 PpiDeclarations.Entry.HelpText:Lang 


Table 5 - 72. PpiDeclarations.Entry.HelpText:Lang 
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Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


5.10 PackageSurfaceArea.PcdDeclarations 


The following is the description of the PackageSurfaceArea.PcdDeclarations 
instance: 


<PcdDeclarations> 
<PcdEntry 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
DisplayInfo=" DisplayType " {0,1}> 
<TokenSpaceGuidCname> xs:NCName </TokenSpaceGuidCname> {1} 
<Token> HexNumber </Token> {1} 
<CName> xs:NCName </CName> {1} 
<DatumType> PcdDatumTypes </DatumType> {1} 
<ValidUsage> PcdItemListType </ValidUsage> {1} 
<DefaultValue> xs:normalizedString </DefaultValue> {1} 
<MaxDatumSize> HexNumber </MaxDatumSize> {0,1} 
<Prompt 
Lang=""_ xs:language " {0,1} > 
xs:normalizedString 
</Prompt> {0,} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
<Abstract 
Lang=""_ xs:language " {0,1} > 
xs :normalizedString 
</Abstract> {0,} 
<PcdError> ... </PcdError> {0,} 
<PcdSubSetting 
PcdBitMask="" HexNumber " {1} 
DisplayInfo=" PcdDisplayTypes " {0,1}> 
<Prompt 
Lang="_ xs:language " {0,1} > 
xs:normalizedString 
</Prompt> {1,} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
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</HelpText> {1,} 
<ValueKeys 
Lang=""xs:language " {0,1} 
Value="_xs:normalizedString " {1} > 
xs :normalizedString 
</ValueKeys> {0,} 
</PcdSubSetting> {0,} 
<PcdValueKeys 
Lang="" xs:language " {0,1} 
Value="_xs:normalizedString " {1} > 
xs :normalizedString 
</PcdValueKeys> {0,} 
</PedEntry> {1,} 
</PcdDeclarations> 


Table 5 - 73. PackageSurfaceArea.PcdDeclarations 


Specifies a list of Pcd entries that are defined by this Package. One and Only One 


Description 
P package can specify these entries. 


Required NO 


Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


5.10.1 PcdDeclarations.PcdEntry 
Table 5 - 74. PcdDeclarations.PcdEntry 


Specifies a single of Pcd entry that are defined by this Package. One and Only One 
package can specify this entry. 


Description 
Required YES 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


5.10.2 PcdDeclarations.PcdEntry:SupArchList 
Table 5 - 75. PcdDeclarations.PcdEntry:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this PCD Entry. 
If this attribute is not specified, then this PCD Entry may be used with any CPU 


D ipti 
aa Architecture. If this attribute is specified, then only those modules that supporta 


subset of the CPU architectures specified by this element may use this PCD Entry. 
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Required NO 


Data Type Attribute — ArchListType 


Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList="IA32” 
Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


5.10.3 PcdDeclarations.PcdEntry:SupModList 
Table 5 - 76. PcdDeclarations.PcdEntry:SupModList 


Used to restrict the set of module types that are allowed to use this PCD Entry. If 
this attribute is not specified, then this PCD Entry may be used with all module 

Description types. If this attribute is specified, then only those modules that have a module type 
that is a member of the set of module types specified by this element may use this 
PCD Entry. 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, UEFI_DRIVER, UEFI_RUNTIME _ 
DRIVER, UEFI_APPLICATION, USER_DEFINED, SMM CORE. 


SupModList=”BASE” 

SupModList=”"”PEIM DXE_DRIVER” 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER” 


Examples 


5.10.4 PcdDeclarations.PcdEntry:PcdDisplayFormat 
Table 5 - 77. PcdDeclarations.PcdEntry:PcdDisplayFormat 


Description Specifies the display type of this PCD Entry. 
Required NO 
Data Type Attribute -PcdDisplayType 


A string that contains the display type of the PCD Entry. PCD display types are 
Data Constraints restricted to the following set: HEX, OCT, DEC, STR, UNISTR, GUID, BOOLEAN, 
BINARY, ENUM, BITS.. 


PcdDisplayFormat = “HEX” 
Examples PcdDisplayFormat=”"O0CT” 
PcdDisplayFormat="BINARY” 
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5.10.5 PcdDeclarations.PcdEntry. TokenSpaceGuidCname 
Table 5 - 78. PcdDeclarations.PcdEntry. TokenSpaceGuidC name 


Specifies the C name of the Token Space GUID of which this PCD Entry is a 
Description member. This C name should also be listed in the GUIDs section (specified above) 
where the C name is assigned to a GUID value in C data structure format. 


Required YES 


Data Type Element — xs:NCName 


A string that starts with either an underscore or a letter, followed by any number of 


Data Constraints a 
letters, digits or underscores. 


<TokenSpaceGuidCName> 


E | 
por gPcdBaseAddress</TokenSpaceGuidCName> 


5.10.6 PcdDeclarations.PcdEntry. Token 
Table 5 - 79. PcdDeclarations.PcdEntry. Token 


Description Specified the 32-bit token value for the PCD Entry 
Required YES 
Data Type Element — HexNumber 


Each PCD Entry in a Token Space must have a unique Token value. This element 


Data Constraints 
must contain one to eight hexadecimal characters. 


<Token>0x00010001</Token> 


Examples <Token>0xA</Token> 


5.10.7 PcdDeclarations.PcdEntry.CName 
Table 5 - 80. PcdDeclarations.PcdEntry.CName 


meseanian Specifies the symbol name for a PCD Entry used in C code. This element is also 
P used by the UI Tools to display the name of the PCD Entry. 

Required YES 

Data Type Element — xs:NCName 


A string that starts with either an underscore or a letter, followed by any number of 


Data Constraints 
letters, digits or underscores. 


Examples <CName> PcdDebugPropertyMask </CName> 


5.10.8 PcdDeclarations.PcdEntry.DatumType 


Table 5 - 81. PcdDeclarations.PcdEntry.DatumType 
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Description Specifies the datum type of this PCD Entry. 


Required YES 
Data Type Element — PcdDataType 


A string that contains the data type of the PCD Entry. PCD data types are restricted 
Data Constraints to the following set: UINT8, UINT16, UINT32, UINT64, VOID*, 
BOOLEAN. 


<DatumType> UINT8 </DatumType> 
Examples <DatumType> VOID* </DatumType> 
<DatumType> BOOLEAN </DatumType> 


5.10.9 PcdDeclarations.PcdEntry.ValidUsage 
Table 5 - 82. PcdDeclarations.PcdEntry. ValidUsage 


Description Specifies the set of valid usages for this PCD Entry. 
Required YES 
Data Type Element — PcdltemListType 


A string that contains one or more PCD Entry item types separated by spaces. The 
Data Constraints PCD Entry item types are restricted to FeaturePcd, FixedPcd, 
PatchPcd, Pcd and/or PcdEx. 


<ValidUsage> FeaturePcd </ValidUsage> 
<ValidUsage> FixedPcd PatchPcd</ValidUsage> 
<ValidUsage> FixedPcd PatchPcd Pcd PcdEx 
</ValidUsage> 


Examples 


Pcd Item Types 

FeaturePcd 
The is a boolean PCD, which can cause different execution paths within a module, 
as well as to include or exclude different elements of a module during a build. 

FixedPcd 
This specifies that the value for this PCD is fixed at build time, and that it can only 
be modified at build time. 

PatenPed 


This specifies that the value for this PCD is set during the build, but that binary 
information about this PCD must be provided, so that the value can be changed prior 
to adding it to a firmware volume, modified within a firmware volume or modified 
within a final flash image prior to installing the image into a firmware device. 


Pod 


This usage is overloaded, with two different meanings. Prior to a build, the platform 
integrator can select whether the PCD will be fixed at build time, patchable, or truly 
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dynamic. A truly dynamic instance requires the addition of a PEI and/or DXE pcd 
driver within a platform to maintain a volatile database of values that can set or 
retrieved. The data store for these entries is platform specific. 

PcdEx 
This specifies that the PCD is always a truly dynamic instance. Truly dynamic PCD 
entries require the addition of a PEI and/or DXE pcd driver within a platform to 
maintain a volatile database of values that can set or retrieved. The data store for 
these entries is platform specific. 


5.10.10 PcdDeclarations.PcdEntry.DefaultValue 
Table 5 - 83. PcdDeclarations.PcdEntry.DefaultValue 


Specifies the default value for the PCD Entry. This default value is only used to 
Description initialize the contents of a platform description or flash definition file when a module 
is added to a platform. 


Required YES 


Data Type Element -— xs:normalizedString 


This element must support strings used to encode all the supported datum types, 
which includes 8, 16, 32, and 64 bit unsigned integers, Booleans, and buffers. The 
buffer types supported are ASCII strings, C format strings, and arrays of byte 
values. 


Data Constraints 


<DefaultValue>0x1f</DefaultValue> 
<DefaultValue>0x80000000</DefaultValue> 
<DefaultValue>234</DefaultValue> 
<DefaultValue>PlatformName</DefaultValue> 
<DefaultValue>L” PlatformName”</DefaultValue> 
<DefaultValue>0x01 0x02 0x03 0x45</DefaultValue> 


Examples 


5.10.11 PcdDeclarations.PcdEntry.MaxDatumSize 
Table 5 - 84. PcdDeclarations.PcdEntry.MaxDatumSize 


Specifies the Maximum Data Size for the PCD Entry. This value is used for VOID* 
DatumType, and should be the Maximum length required for the PCD’s typical 
usage. Platform description files may over-ride this value — if and only if they 
specify a larger data size. 


Description 


Required YES — Only for VOID* DatumType PCDs 


Data Type Element — HexNumber 


Data Constraints This element is used for data structures to eliminate buffer-overruns. 


<MaxDatumSize>0x1f</MaxDatumSize> 


Examibles <MaxDatumSize> 0x20000 </MaxDatumSize> 


eae 
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5.10.12 PcdDeclarations.PcdEntry.Prompt 
Table 5 - 85. PcdDeclarations.PcdEntry.Prompt 


A string that can be used to map a VFR 
question toa PCD 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 
Data Constraints 


<Prompt> Enter the maximum number of 


E I 
eae vertical lines of the Display</Prompt> 


5.10.13 PcdDeclarations.PcdEntry.Prompt:Lang 


PcdDeclarations.PcdEntry.Prompt:Lang 


The language code uses an RFC 1766 


D ipti 
escription language code identifier 


Required NO 


Data Type Attribute — xs:language 


If present, the language code must use an 
Data Constraints RFC 1766 language code identifier. If not 
specified, the default is “en-us.’ 


Lang="en-us” 


E | 
le ala Lang="fra” 


5.10.14 PcdDeclarations.PcdEntry.HelpText 
Table 5 - 86. PcdDeclarations.PcdEntry.HelpText 


A complete description of a PCD Entry including the intended use models of the 
PCD Entry, its valid usage, its data type, and any value assignment constraints. It 
must also describe any use restrictions based on Module Type, CPU Architecture, 
and/or Feature Flags. 


Description 


Required NO 
Data Type Element -— xs:string 


Data Constraints A string that contains one or more lines of text. 


<HelpText> 

The PcdDebugPropertyMask is an 8-bit mask of 
debug properties that may be set to a unique 
value for each module in the platform. This PCD 


Examples 
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Entry is available to all CPU and Module types 
and may be configured as FIXED AT BUILD or 
BINARY PATCHABLE and supports the following bit 


settings: 
#define DEBUG PROPERTY DEBUG ASSERT ENABLED 0x01 
#define DEBUG PROPERTY DEBUG PRINT ENABLED 0x02 
#define DEBUG_PROPERTY_DEBUG CODE ENABLED 0x04 
#define DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED 0x08 
</HelpText> 


5.10.15 PcdDeclarations.PcdEntry.HelpText:Lang 
Table 5 - 87. PcdDeclarations.PcdEntry.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
toe Lang="fra” 


5.10.16 PcdDeclarations.PcdEntry.Abstract 
Table 5 - 88. PcdDeclarations.PcdEntry.Abstract 


Description A brief description of a PCD Entry. 
Required NO 

Data Type Element — xs:string 

Data Constraints A string that contains one line of text. 


The PcdDebugPropertyMask is an 8-bit mask of debug properties that may be set 


Examples to a unique value for each module in the platform. 


</HelpText> 


5.10.17 PcdDeclarations.PcdEntry.Abstract:Lang 


Table 5 - 89. PcdDeclarations.PcdEntry.Abstract.Langt 


Description The language code uses an RFC 1766 language code identifier. 
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Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
Bie Gonstaints not specified, the default is “en-us.’ 


Lang="en-us” 
Examples 


Lang="fra” 


5.10.18 PcdDeclarations.PcdEntry.PcdError 


<PcdError> 
Choice (One and only one of the following must be selected) 
<ValidValueList 
Lang="_ xs:language " {0,1} > 
xs:normalizedString 
</ValidValueList> 
<ValidValueRange> xs:normalizedString </ValidValueRange> 
<Expression> xs:normalizedString </Expression> 
End Choice 
<ErrorNumber> HexNumber </ErrorNumber> {1} 
<ErrorMessage 
Lang="_xs:language " {0,1} > 
xs:string 
</ErrorMessage> {1,} 
</PcdError> 


Table 5 - 90. PcdDeclarations.PcdEntry.PcdError 
Valid Error messages implemented in this module for the PCD Entry. Only One 


Description Error Number per PcdError, (multiple ErrorMessage entries are permitted) and 
multiple PcdError elements are permitted. 


Required NO 


Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


5.10.19 PcdDeclarations.PcdEntry.PcdError.ValidValueList 


Table 5 - 91. PcdDeclarations.PcdEntry.PcdError.ValidValueList 


Description A list of valid values 


Required NO 
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Data Type Element — xs:normalizedString 


Space Separated list of values. Restricted to the data type of this PCD. Use of the 
L’string” is permitted to specify a UTF-8 text string that will be converted to UNICODE 
(UCS2) format in the code. Words that are not quoted are considered to be 
enumerations. 


Data Constraints 


<ValidValueList> 0xb0000000 0xb0000001 
</ValidValueList> 

<ValidValueList> “Blue” “Red” “White” 
</ValidValueList> 

<ValidValueList> orange peach apple pear 
</ValidValueList> 


Examples 


5.10.20 PcdDeclarations.PcdEntry.PcdError.ValidValueList:Lang 
Table 5 - 92. PcdDeclarations.PcdEntry.PcdError.ValidValueList:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
ale Gonswaints not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
ae Lang="fra” 


5.10.21 PcdDeclarations.PcdEntry.PcdError.ValidValueRange 
Table 5 - 93. PcdDeclarations.PcdEntry.PcdError.ValidValueRange 


Description The valid range of values using C style nomenclature. 
Required NO 
Data Type Element -— xs:normalizedString 


This is required to be an in-fix logical expression, evaluated left to right, for a range 
of values, using Relational, Equality and Logical Operators (NOT, OR, AND, LT, 
LE, EQ, GT, GE and XOR) that must evaluate to either True or False. The forms 

Data Constraints PcdCName and/or PcdTokenSpaceGuidCName.PcdCName are permitted; if only 
the PcdCName is specified, then the PcdTokenSpaceGuidC Name is the same as 
this PCD's TokenSpaceGuidCName. Parentheses are recommended for clarity. All 
other values must be numeric. 


<ValidValueRange> (0xb0000000 LE PcdCNameGoesHere 
) AND (PcdCNameGoesHere GT 0x00010000) 


Examples 
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</ValidValueRange> 


<ValidValueRange> PcdCNameGoesHere LT 0x10001FFF 
AND (PcdCNameGoesHere NOT EQ 0x8000000) 
</ValidValueRange> 


5.10.22 PcdDeclarations.PcdEntry.PcdError.Expression 


Table 5 - 94. PcdDeclarations.PcdEntry.PcdError.Expression 


An in-fix logical expression, evaluated left to right, using Relational, Equality and 
Logical Operators (NOT, AND, OR, GT, GE, EQ, LE, LT and XOR) and parenthesis 
are recommended. The forms PcdCName and/or 


Benaiiey PcdTokenSpaceGuidCName.PcdCName are permitted; if only the PcdCName is 
specified, then the PcdTokenSpaceGuidCName is the same as this PCD's 
TokenSpaceGuidCName. 

Required NO 

Data Type Element -— xs:normalizedString 


Data Constraints 


<Expression> (NOT gPcdRecoveryMode) AND 


Examples : 
° gPcdS3Resume </Expression> 


5.10.23 PcdDeclarations.PcdEntry.PcdError.ErrorNumber 


Table 5 - 95. PcdDeclarations.PcdEntry.PcdError.ErrorNumber 


A 32-bit token value for the PCD Error Number that is unique to the token space 
GUID C name of the PCD declared by this package. The Error Number can be 
used as an index of messages provided for a token space defined by the token 
space GUID C name. 


Description 


Required YES 
Data Type Element — HexNumber 


Each PCD Error Number in a Token Space must have a unique Error Number 


Data Constraints 
value. This element must contain one to eight hexadecimal characters. 


<ErrorNumber>0xb0000000</ErrorNumber> 


a <ErrorNumber>0xb0000001</ErrorNumber> 


5.10.24 PcdDeclarations.PcdEntry.PcdError.ErrorMessage 
Table 5 - 96. PcdDeclarations.PcdEntry.PcdError.ErrorMessage 


Description An error message for conditional failures of the choices above. 


Required YES 


ee 
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Data Type Element -— xs:string 


Data Constraints A string that contains one or more lines of text. 


<ErrorMessage> The value specified exceeds the 


Examples 
P maximum value allowed. </ErrorMessage> 


5.10.25 PcdDeclarations.PcdEntry.PcdError.ErrorMessage:Lang 
Table 5 - 97. PcdDeclarations.PcdEntry.PcdError.ErrorMessage:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraint 
pee ron engn not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
eee Lang="fra” 


5.10.26 PcdDeclarations.PcdEntry.PcdSubSetting 
Table 5 - 98. PcdDeclarations.PcdEntry.PcdSubSetting 


Description Specifies the sub-setting information for this PCD. 
Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


5.10.27 PcdDeclarations.PcdEntry.PcdSubSetting:PcdBitMask 
Table 5 - 99. PcdDeclarations.PcdEntry.PcdSubSetting:PcdBitMask 


Description The subset of bits in the main PCD that this subset controls. 
Required Yes 
Data Type Attribute — HexNumber 


Data Constraints N/A 


Examples PcdBitMask ="0x11" 


5.10.28 PcdDeclarations.PcdEntry.PcdSubSetting:DisplayInfo 
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Table 5 - 100. PcdDeclarations.PcdEntry.PcdSubSetting:Displaylnfo 


Description Specifies the display type of this PCD subsetting 


Required NO 
Data Type Attribute — PcdDisplayType 


A string that contains the display type of the PCD Entry. PCD display types are 
Data Constraints restricted to the following set: HEX, OCT, DEC, STR, UNISTR, GUID, BOOLEAN, 
BINARY, ENUM, BITS. 


DisplayInfo = “HEX” 
Examples DisplayInfo =”OCT” 
DisplayInfo =”BINARY” 


5.10.29 PcdDeclarations.PcdEntry.PcdSubSetting.Prompt 
Table 5 - 101. PcdDeclarations.PcdEntry.PcdSubSetting.Prompt 


Description A prompt for this subsetting. 

Required NO 

Data Type Attribute — xs:string 

Data Constraints A string that contains one or more lines of text. 


<HelpText>Enable ASSERT in debug 


E | 
pike library</HelpText> 


5.10.30 PcdDeclarations.PcdEntry.PcdSubSetting.Prompt:Lang 
Table 5 - 102. PcdDeclarations.PcdEntry.PcdSubSetting.Prompt:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraint 
eae not specified, the default is “en-us.’ 


Examples Lang="en-us” 


5.10.31 PcdDeclarations.PcdEntry.PcdSubSetting.HelpText 


Description A complete description of a subsetting. 


Required NO 
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Data Type Attribute — xs:string 


Data Constraints — A string that contains one or more lines of text. 


<HelpText>ASSERT will cause an ASSERT when a 


Examples 
fault occurs</HelpText> 


5.10.32 PcdDeclarations.PcdEntry.PcdSubSetting.HelpText:Lang 
Table 5 - 103. PcdDeclarations.PcdEntry.PcdSubSetting.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


5.10.33 PcdDeclarations.PcdEntry.PcdSubSetting.ValueKeys 
Table 5 - 104. PcdDeclarations.PcdEntry.PcdSubSetting. ValueKeys 


A description of one string to value conversion that a user could select for this PCD 
subsetting. 


Description 
Required NO 
Data Type Attribute — xs:normalizedString 


Data Constraints A string that contains line of text. 


<PcdValueKeys Value = "0x01"> 
Examples DEBUG PROPERTY _ DEBUG ASSERT ENABLED 
</PcdValueKeys> 


5.10.34 PcdDeclarations.PcdEntry.PcdSubSetting.ValueKeys:Lang 
Table 5 - 105. PcdDeclarations.PcdEntry.PcdSubSetting. ValueKeys:Lang 


Description The language this key is in. 


Required NO 


Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
ala Constants not specified, the default is “en-us.’ 
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Lang="en-us” 


E | 
ee Lang="fra” 


5.10.35 PcdDeclarations.PcdEntry.PcdSubSetting.ValueKeys:Value 


Table 5 - 106. PcdDeclarations.PcdEntry.PcdSubSetting. ValueKeys:Value 


Description The value for the PCD subsetting if this entry is selected 


Required NO 
Data Type Element —xs:normalized String 


This element must support strings used to encode all the supported datum types, 
which includes 8, 16, 32, and 64 bit unsigned integers, Booleans, and buffers. The 
buffer types supported are ASCII strings, C format strings, and arrays of byte 
values. 


Data Constraints 


Value="test” 
Examples Value = “0x1f” 
Value = “0x01 0x02 0x03 0x045” 


5.10.36 PcdDeclarations.PcdEntry.PcdValueKeys 
Table 5 - 107. PcdDeclarations.PcdEntry.PcdValueKeys 


A description of one string to value conversion that a user could select for this 
PCD. 


Description 
Required NO 
Data Type Element —xs:normalized String 


Data Constraints A string that contains line of text. 


<PcdValueKeys Value = 0x01> 
Examples DEBUG PROPERTY DEBUG ASSERT ENABLED 
</PcdValueKeys> 


5.10.37 PcdDeclarations.PcdEntry.PcdValueKeys:Lang 
Table 5 - 108. PcdDeclarations.PcdEntry.PcdValueKeys:Lang 


Description The language this key is in. 
Required NO 


Data Type Element -— xs:language 


Data Constraints If present, the language code must use an RFC 1766 language code identifier. If 
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not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
uae Lang="fra” 


5.10.38 PcdDeclarations.PcdEntry.PcdValueKeys:Value 
Table 5 - 109. PcdDeclarations.PcdEntry.PcdValueKeys:Value 


Description The value for the PCD if this entry is selected. 
Required NO 
Data Type Element — xs:normalizedString 


This element must support strings used to encode all the supported datum types, 
which includes 8, 16, 32, and 64 bit unsigned integers, Booleans, and buffers. The 

Data Constraints buffer types supported are ASCII strings, C format strings, and arrays of byte 
values. 


Value="test” 
Examples Value = “0x1f” 
Value = “0x01 0x02 0x03 0x045” 


5.11 PackageSurfaceArea.PcdRelationshipChecks 


The following is the description of the PackageSurfaceArea.RelationshipChecks 
instance: 
<PcdRelationshipChecks> 
<PcdCheck> xs:normalizedString </PcdCheck> {1,} 
<PcdRelationshipChecks> 


Table 5 - 110. PackageSurfaceArea.PcdRelationshipChecks 


This element is used to list any dependency or relationship expressions for PCDs 


D ipti 
sil at a global level. 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


5.11.1 PcdRelationshipChecks.PcdCheck 


Table 5 - 111. PcdRelationshipChecks.PcdC heck 
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If one or more of this package’s PCD settings may be dependent on a different 
Description PCD or have a specific relationship, then the relationship can be specified here. 
Each PCD is named by TokenSpaceGuidCname.PcdCname. 


Required YES 


Data Type Element -— xs:normalizeString 


An in-fix logical expression, evaluated left to right, PCDs that are interdependent or 
have a limiting relationship, using Relational, Equality and Logical Operators 
(NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that must evaluate to either True or 
False. Only the C name for this PCD is permitted in the ValidValueRange 
expression. Parentheses are recommended for clarity. All other values must be 
numeric. 


Data Constraints 


<PcdCheck> gloSerialTokenSpace.myComPortlInt XOR 
gloSerialTokenSpace.myComPort2Int </PcdCheck> 

Examples <PcdCheck> gIoTokenSpace.mPciBaseAddress LT 
gVideoTokenSpace .mNoSuchVideoDriverBaseAddress 
</PcdCheck> 


5.12 PackageSurfaceArea.MiscellaneousFiles 


The following is the description of the PackageSurfaceArea .MiscellaneousFiles 
instance: 


<MiscellaneousFiles> 
<Copyright> xs:string </Copyright> {0,1} 
<License> xs:string </License> {0,1} 
<Abstract> xs:string </Abstract> {0,1} 
<Description> xs:string </Description> {0,} 
<Filename 

Executable="_ xs:boolean " {0,1} > 
xs:anyURI 

</Filename> {1,} 

</MiscellaneousFiles> 


Table 5 - 112. PackageSurfaceArea.MiscellaneousFiles 


-— This element contains any miscellaneous files that are not part of code distributed 
Description : : 
with this package. 
Required NO 
Data Type Element — Complex 


Data Constraints Free-form text or any well formed XML element(s.) 


Examples N/A 


5.12.1 MiscellaneousFiles.Copyright 
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Table 5 - 113. MiscellaneousFiles.Copyright 


The copyright for this section if itis different than the copyright specified in the 
package header. The copyright is generated by the creator of the tool. Ifa 

Description derivative work is generated from an existing section, then the existing copyright 
must be maintained, and additional copyrights may be appended to the end of this 
element. 


Required NO 


Data Type Element — xs:string 
Data Constraints A set of one or more copyright statements on one or more lines of text. 


<Copyright> Copyright (c) 2008, Nosuch 


E I 
nenere Corporation. All rights reserved. </Copyright> 


5.12.2 MiscellaneousFiles.License 
Table 5 - 114. MiscellaneousFiles.License 


A license that describes any restrictions on the use of this tool if it is different than 
the license specified in the package header. Ifa derivative work is allowed by the 

Description original license and a derivative work is generated from an existing package, then 
the existing license must be maintained, and additional licenses may be appended 
to the end of this element. 


Required NO 
Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<License> 


This program and the accompanying materials are 
licensed and made available under the terms and 
conditions of the BSD License which accompanies 
this distribution. The full text of the license 


may be found at 


E l 
xamples http: //opensource.org/licenses/bsd-license.php 


THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE 
ON AN ‘AS IS’ BASIS, WITHOUT WARRANTIES OR 
REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR 
IMPLIED. </License> 


5.12.3 MiscellaneousFiles.Abstract 


Table 5 - 115. MiscellaneousFiles.Abstract 
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Description A one line description of the content in this section. 


Required NO 
Data Type Element — xs:string 
Data Constraints String value of one or more characters. 


<Abstract>Special Build Rules 1 for processing 


E I 
aa aia file type foo</Abstract> 


5.12.4 MiscellaneousFiles.Description 
Table 5 - 116. MiscellaneousFiles.Description 


Any additional detailed information that might be appropriate for content in this 
section. 


Description 
Required NO 
Data Type Element -— xs:string 


Data Constraints A string that contains one or more lines of text. 


<Description> Detailed instructions for using 


Examples 
7 this package. </Description> 


5.12.5 MiscellaneousFiles.Filename 
Table 5 - 117. MiscellaneousFiles.Filename 


A file that is included in the distribution package that does not pertain to any of the 


D ipti 
a ac previously defined sections. 


Required YES 


Data Type Element — xs:anyURI 


The PackagePath relative path and filename of the file in the Distribution Content 


Data Constraints ; 
File. 


<File>FooBarMfgBuild/ReadMe.txt</File> 


Eres <File> FooBarSpecification.pdf </File> 


5.12.6 MiscellaneousFiles.Filename:Executable 
Table 5 - 118. MiscellaneousFiles.Filename:Executable 


Description This flag is used during installation to ensure that the file is executable. 


Required NO 
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Data Type Attribute — xs:boolean 


Data Constraints “true’ or “false” (default) 


Examples Executable=”true” 


5.13 PackageSurfaceArea.UserExtensions 
The following is the description of the PackageSurfaceArea.UserExtensions instance: 
<UserExtensions 
UserId=""xs:NCName " {1} 
Identifier="_xs:string " {1} 
AnyAttribute {0,} > 


Any Text or XML Format 
</UserExtensions> 


Table 5 - 119. PackageSurfaceArea.UserExtensions 


This section is used for any processing instructions that may be custom to the 
Description content provided by the distribution that are common to package. Processing of 
this section is specified as “lax”. 


Required NO 
Data Type Element — Complex 
Data Constraints None 


Examples N/A 


5.13.1 UserExtensions:Userld 
Table 5 - 120. UserExtensions:Userld 


Description The normative reference name to identify the originator of this information. 
Required YES 
Data Type Attribute — xs:NCName 


A string that starts with a letter followed by any combination of letters, digits, 


Data Constraints : ; 
underscores, and periods. No whitespace characters are allowed. 


Examples UserId="NoSuchCorp” 


5.13.2 UserExtensions:Identifier 


Table 5 - 121. UserExtensions:Identifier 
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This can be used to differentiate multiple sections with a grouping. 


Yes 
Attribute— xs:string 


A string that starts with a number or letter followed by any combination of letters, 
digits, underscores, dashes and periods. Whitespace characters are allowed. 


Identifier="Special Build Rules 1” 
Identifier="f£6665cf5-8290-4b02-ba0c-5cb5a9542176" 
Identifier=”"PRE_ BUILD” 
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Chapter 6 - 
Module Surface Area Description 


A distribution surface area may contain zero or more Module Surface Area sections. Within the 
Module Surface Area only the attributes and the Header section are required. The remaining 
sections are optional. 


The XML Instance Representation for DistributionPackage .ModuleSurfaceArea is 
as follows: 
<ModuleSurfaceArea 
BinaryModule=" xs:boolean " {0,1} > 
<Header> ... </Header> {1} 
<ModuleProperties> ... </ModuleProperties> {0,1} 
<ClonedFrom> ... </ClonedFrom> {0,1} 
<LibraryClassDefinitions> ... </LibraryClassDefinitions> {0,1} 
<SourceFiles> ... </SourceFiles> {0,1} 
<BinaryFiles> ... </BinaryFiles> {0,1} 
<PackageDependencies> ... </PackageDependencies> {0,1} 
<Guids> ... </Guids> {0,1} 
<Protocols> ... </Protocols> {0,1} 
<PPIs> ... </PPIs> {0,1} 
<Externs> ... </Externs> {0,1} 
<PcedCoded> ... </PcdCoded> {0,1} 
<PeiDepex> ... </PeiDepex> {0,} 
<DxeDepex> ... </DxeDepex> {0,} 
<SmmDepex> ... </SmmDepex> {0,} 
<MiscellaneousFiles> ... </MiscellaneousFiles> {0,1} 
<UserExtensions> ... </UserExtensions> {0,} 
</ModuleSurfaceArea> 


Table 6 - 1. ModuleSurfaceArea 


Description Specifies contents of a Module that is provided by this distribution package. 


Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.1 ModuleSurfaceArea:BinaryModule 


Table 6 - 2. ModuleSurfaceArea:BinaryModule 


«93. 


Chapter 6 


This attribute is used when the binaries are distributed for this module and no code 
Description generation from source files is required. If set, then the binary section should be 
used, and any files listed in the SourceFiles section do not have to be built. 


Required NO 
Data Type Attribute — xs:boolean 


For binary only modules, this value should be set to “true”, Default (or non- 


Data Constraints . 
specified) value is “false’. 


Examples BinaryModule=”"true” 


6.2 ModuleSurfaceArea.Header 


The following is the description of the ModuleSurfaceArea. Header instance: 
<Header> 
<BaseName> 
xs :Nmtoken 
</BaseName> {1} 
<Name 
Lang=""_ xs:language " {0,1} > 
xs :normalizedString 
</Name> {1,} 


<GUID 
Version=""xs:decimal " {1} > 
RegistryFormatGuid 


</GUID> {1} 
<Copyright> xs:string </Copyright> {0,1} 
<License> xs:string </License> {0,1} 
<Abstract 
Lang=""_ xs:language " {0,1} > 
xs:normalizedString </Abstract> {0,} 
<Description 
Lang="_ xs:language " {0,1} > 
xs:string </Description> {0,} 
</Header> 


Table 6 - 3. ModuleSurfaceArea. Header 


This element contains the header information for Module Surface Area Description. 
This includes the name of the module, descriptions of the module, copyright and 
licensing information associated with the module, and the version of XML Schema 
to which this file conforms. 


Description 


Required YES 


Data Type Element — Complex 
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Data Constraints N/A 


Examples N/A 


6.2.1 Header.Name.BaseName 
Table 6 - 4. Header.Name:BaseName 


This is a single word BaseName that may be used to create output file names and 


Description 
P directories. 


Required YES 


Data Type Attribute - xs:Nmtoken 


It must be a word made up of one or more alphanumeric characters. Non-word 
Data Constraints characters: underscore "_", dash "-", and period"." are permitted after the first 
character. 


BaseName=”IntelIch7” 


E | 
oon BaseName="Foo_bar-1_ ten” 


6.2.2 Header.Name 
Table 6 - 5. Header.Name 


Besedsten The User Interface Name for the module. This name is only used by a user 
° interface to display the name of the module. 

Required YES 

Data Type Element -— xs:normalizedString 


Data Constraints String value of one or more characters. 


Examples <Name> USB 1.0 I/O Driver </Name> 


6.2.3 Header.Name:Lang 
Table 6 - 6. HeaderName:Lang 


Description The language code uses an RFC 1766 language code identifier. 
Required NO 
Data Type Attribute - xs:language 


If present, the language code must use an RFC1766 language code identifier. If 


Data Constraint 
a senna not specified, the default is “en-us.’ 


Lang="en-us” 
Lang="fra” 


Examples 
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6.2.4 Header.Name.BaseName 


Table 6 - 7. Header.Name:BaseName 


Description 


Required 


Data Type 


Data Constraints 


Examples 


6.2.5 Header.GUID 


This is a single word BaseName that may be used to create output file names and 
directories. 


YES 
Attribute - xs:Nmtoken 


It must be a word made up of one or more alphanumeric characters. Non-word 
characters: underscore "_", dash "-", and period"." are permitted after the first 
character. 


BaseName="IntelIch7” 
BaseName="Foo_bar-1_ ten” 


Table 6 - 8. Header.GUID 


Description 


Required 


Data Type 


Data Constraints 


Examples 


6.2.6 Header.GUID: 


The 128-bit registry format GUID that is the unique name of a module. The GUID 
must change if a change is made that is not backward compatible. 


YES 
Element — RegistryFormatGuid 


A string that represents a GUID in registry format. 

Ifa module is backwards compatible with a previous release of the same module, 
then ModuleSurfaceArea.Header.GUID element must not be 
changed, and only the 

ModuleSurfaceArea.Header .GUID: Version element should be 
increased. If a module is not backward compatible with a previous release, then a 
new ModuleSurfaceArea .Header .GUID must be generated. 


<GUID Version="0.3”> AFODDA2E-EA83-480b-B2CE- 
FCOBB2F894C2 </GUID> 


Version 


Table 6 - 9. Header.GUID:Version 


Description 


Required 


Data Type 


Data Constraints 


The version of this Module. 
YES 
Attribute — xs:decimal 


A string that contains a positive decimal number with a dot separator. 
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Version="1.00” 


Examples Version="1.02” 
Version="3.27” 


6.2.7 Header.Copyright 
Table 6 - 10. Header.Copyright 


This field is require only if the copyright of this module is different from the 
copyright of the container package that provides this module. The copyright for this 
Description module thatis generated by the creator of a module. If a derivative work is 
generated from an existing module, then the existing copyright must be 
maintained, and additional copyrights may be appended to the end of this element. 


Required NO 
Data Type Element -— xs:string 
Data Constraints A set of one or more copyright statements on one or more lines of text. 


<Copyright> 

Copyright (c) 2006, Nosuch Corporation. All 
rights reserved. 

</Copyright> 


Examples 


6.2.8 Header.License 
Table 6 - 11. Header.License 


This field is only required if the module license is different from the container 
package license. A license that describes any restrictions on the use of this 
module. If a derivative work is allowed by the original license and a derivative work 

Description is generated from an existing module, then the existing license must be 
maintained, and additional licenses may be appended to the end of this element. 
Alternative, this may point to a file which is located in the same directory a the 
module description file. 


Required NO 
Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<License> 

This program and the accompanying materials are 
licensed and made available under the terms and 
conditions of the BSD License which accompanies 


Examples 
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this distribution. The full text of the license 


may be found at: 
http: //opensource.org/licenses/bsd-license.php 
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE 


ON AN AS IS BASIS, WITHOUT WARRANTIES OR 
REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR 
IMPLIED. 

</License> 

<License> License.txt </License> 


6.2.9 Header.Abstract 


Table 6 - 12. Header.Abstract 


Description 
Required 

Data Type 

Data Constraints 


Examples 


Aone line description of the module. 
NO 

Element — xs:normalizedString 

String value of one or more characters. 


<Abstract> USB I/O Driver Version 1.0 </Abstract> 


6.2.9.1 Header.Abstract:Lang 


Table 6 - 13. Header.Abstract:Lang 


Description 
Required 


Data Type 


Data Constraints 


Examples 


The language code uses an RFC 1766 language code identifier 
NO 
Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 
not specified, the default is “en-us.’ 


Lang="en-us” 
Lang="fra” 


6.2.10 Header.Description 


Table 6 - 14. Header.Description 


Description 


A complete description of the module. This description must include the release 
name of the module, the version of the module, and a complete description of the 
module contents and/or features including a description of the updates since the 
previous module release. 
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Required NO 


Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<Description> 

USB I/O Driver Version 1.0 that conforms to the 
Examples USB 2.2 specification. The module handles all USB 

I/O functions. 

</Description> 


6.2.10.1 Header:Description:Lang 


Table 6 - 15. Header.Description:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code 


Data Constraints .)" ; : 
identifier. If not specified, the default is “en-us.” 


Lang="en-us” 


Examples 


Lang="fra” 


6.3 ModuleSurfaceArea.ModuleProperties 


The following is the description of the ModuleSurfaceArea.ModuleProperties 
instance: 
<ModuleProperties 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} > 

<ModuleType> ModuleTypes </ModuleType> {1} 

<Path> xs:anyURI </Path> {1} 

<PcdIsDriver> PcdDriverTypes </PcdIsDriver> {0,1} 

<UefiSpecificationVersion> xs:decimal </UefiSpecificationVersion> 
{0,1} 

<PiSpecificationVersion> xs:decimal </PiSpecificationVersion> 
{0,1} 

<Specification 

Version=""_xs:decimal " > 
xs :NCName 

</Specification> {0,} 

<BootMode> ... </BootMode> {0,} 

<Event> ... </Event> {0,} 

<HOB> ... </HOB> {0,} 
</ModuleProperties> 
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Table 6 - 16. ModuleSurfaceArea.ModuleProperties 


Description 


Required 
Data Type 
Data Constraints 


Examples 


List general information about a module, including the Supported Architectures, 
the version of the UEFI and PI specs a module may conform to, and non-GUIDed 
information, such as boot modes a module might set, timer events, or hand off 
blocks. 


NO 
Element — Complex 
N/A 


N/A 


6.3.1 ModuleProperties:SupArchList 


Table 6 - 17. ModuleProperties:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this module. If 
this attribute is not specified, then this module may be used with any CPU 
Architecture. If this attribute is specified, then only those platforms that support a 
subset of the CPU architectures specified by this element may use this module. 
The list of Architectures that this module was designed to support and that ithas 
been tested on. 


NO 
Attribute — ArchListType 
[A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList="IA32” 
SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.3.2 ModuleProperties:SupModList 


Table 6 - 18. ModuleProperties:SupModList 


Description 
Required 


Data Type 


Data Constraints 


Used by Libraries to restrict the set of modules that the code in this library supports. 
NO 


Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, UEFI_DRIVER, UEFI_RUNTIME _ 
DRIVER, UEFI_APPLICATION, USER DEFINED, SMM CORE. 
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SupModList=” BASE” 


SupModList=”"”PEIM DXE_DRIVER” 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER” 


Examples 


6.3.3 ModuleProperties.ModuleType 
Table 6 - 19. ModuleProperties.ModuleType 


Description Define the Module type that this module is. 
Required YES 
Data Type Element — ModuleType 


If specified, must contain one and only one of the supported module types. The 
supported module types include BASE, SEC, PEI_CORE, PEIM, DXE_CORE, 

Data Constraints DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL DRIVER, DXE _ 
SMM DRIVER, UEFI_DRIVER, UEFI_RUNTIME DRIVER, UEFI_ 
APPLICATION, USER_DEFINED ,SMM_ CORE.. 


<ModuleType> BASE </MODULE_TYPE> 
Examples <ModuleType> PEIM </MODULE_TYPE> 
SupModList=“UEFI_DRIVER” 


6.3.4 ModuleProperties.Path 
Table 6 - 20. ModuleProperties.Path 


For stand-alone modules that are NOT part of any package, this is the path to the 
root of the module as listed in the Distribution Content File. For modules included 
in a package, this is the location, relative to the root of the package this module 
belongs to. 


Description 


Required YES 
Data Type Element -— xs:anyURI 


A valid (Distribution Content File or Package) relative path to the root of the 


Data Constraints 
a Module. 


<Path>Libraries/BaseLib</Path> 
Examples <Path> EfiShellBin </Path> 
<Path>Universal/Disk/DiskIo/Dxe</Path> 


6.3.5 ModuleProperties.PcdlsDriver 


Table 6 - 21. ModuleProperties.PcdlsDriver 


- 101 - 


Chapter 6 


This element is only required for the PEIM that produces the PCD PPI or the DXE 
Driver that produces the PCD Protocol. 


Description 


Required NO 
Data Type Element — xs:NCName 
Data Constraints One of enumerated type: PEI_PCD_DRIVERorDXE_PCD DRIVER 


<PcdIsDriver>PE I_PCD_DRIVER</PcdI sDriver> 


Exampl 
ai sic <PcdIsDriver>DXE_PCD DRIVER</PcdIsDriver> 


6.3.6 ModuleProperties.UefiSpecificationVersion 
Table 6 - 22. ModuleProperties.UefiSpecificationVersion 


The number should reflect the version of the UEFI specification that the module 
conforms to. This value should be provided. 


Description 
Required NO 
Data Type Element — xs:decimal 


Data Constraints A decimal value that must include the period character. 


<UefiSpecificationVersion> 2.1 


Examples 
P </UefiSpecificationVersion> 


6.3.7 ModuleProperties.PiSpecificationVersion 
Table 6 - 23. ModuleProperties.PiSpecificationVersion 


The number should reflect the version of the PI specification that the module 
conforms to. This may be left blank. 


Description 
Required NO 
Data Type Element — xs:decimal 


Data Constraints A decimal value that must include the period character. 


<PiSpecificationVersion> 1.0 


Examples 
P </PiSpecificationVersion> 


6.3.8 ModuleProperties.Specification 
Table 6 - 24. ModuleProperties.Specification 


One or more of these elements indicate that the module has been coded to 
conform to the specified Industry Standard Specifications. 


Description 
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Required NO 


Data Type Element — xs:NCName 


Data Constraints NA 


<Specification Version="1.0”> NoSuch_ MACHINE DOT _ 


E I 
oes COM </Specification> 


6.3.9 ModuleProperties.Specification:Version 
Table 6 - 25. ModuleProperties.Specification:Version 


The Industry Standard spec version of this Module. If a module is coded to support 
Description more than one version of a spec, such as support for USB 1.1 and USB 2.0 
specifications, then two different Specification lines should be used. 


Required YES 
Data Type Attribute — xs:decimal 
Data Constraints A decimal value that must include the period character. 


Version="1.0” 
Examples Version="1.1” 
Version="2.0” 


6.3.10 ModuleProperties.BootMode 
<BootMode> 
Usage=" one of the enumerated values " {1} 
SupArchList=" ArchListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
<SupportedBootModes> list of Boot Modes </SupportedBootModes> {1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</BootMode> {1,} 


Table 6 - 26. ModuleProperties. BootMode 


Description This is a list of boot modes supported or set by this module. 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.3.11 ModuleProperties.BootMode:Usage 
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Table 6 - 27. ModuleProperties. BootMode:Usage 


Description 
Required 


Data Type 


Data Constraints 


Examples 


This element specifies the GUID Usage. 
YES 


Attribute - UsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 
CONSUMES or SOMETIMES PRODUCES 


CONSUMES means that the module supports the boot mode or that it may support 
the boot mode on some execution paths. 

PRODUCES means that the module will change the boot mode 

UNDEFINED - Implies that a Boot Mode is used, but the package creator does 
not know how it used. 


Usage=” PRODUCES” 
Usage=”"CONSUMES” 


6.3.12 ModuleProperties.BootMode:SupArchList 


Table 6 - 28. ModuleProperties.BootMode:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this Boot 
Mode. If this attribute is not specified, then this Boot Mode may be used with any 
CPU Architecture. If this attribute is specified, then only those modules that support 
a subset of the CPU architectures specified by this element may use this 
BootMode. 


NO 
Attribute — ArchListType 
[A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList=“IA32” 
SupArchList=“IA32 X64” 
SupArchList=“EBC IPF X64” 


6.3.13 ModuleProperties.BootMode:FeatureFlag 


Table 6 - 29. ModuleProperties.BootMode:FeatureFlag 


Description 


Used to restrict the use of this Boot Mode. An in-fix logical expression, evaluated 
left to right, for a range of values, using Relational, Equality and Logical Operators 
(NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that must evaluate to either True or 
False. The form PcdTokenSpaceGuidCName.PcdCName is required. 
Parentheses are recommended for clarity. If this attribute is specified, then this 
Boot Mode may only be used if the Boolean expression evaluates to true. 


- 104 - 


Chapter 6 - Module Surface Area Description 


Required NO 


Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE , GT 


Data Constraints and GE. 


Examples FeatureFlag=”"true” 


6.3.14 ModuleProperties.BootMode.SupportedBootModes 
Table 6 - 30. ModuleProperties.BootMode.SupportedBootMode 


Firmware execution paths are divided into two main categories, a normal boot and 
a recovery boot (in the case of potential corruption.) Within these two paths, 
different paths can be taken based on a given state of the firmware, or through 
Description feature settings. ABootMode GUID can be installed (PRODUCES) or located 
(CONSUMES) based on these states and feature settings. The majority of these 
types map to the PI specification Boot Mode Services. The boot modes listed with 
Recovery are to indicate that the GUID is only valid during a recovery boot. 


Required YES 
Data Type Element — BootModeList 


One or more (space separated) of the enumerated data types: FULL, 
MINIMAL,NO_ CHANGE, DIAGNOSTICS, DEFAULT, S2_ RESUME, S3__ 
RESUME,S4 RESUME,S5 RESUME, FLASH UPDATE, RECOVERY _ 
FULL, RECOVERY_MINIMAL, RECOVERY _NO CHANGE, RECOVERY _ 
Data Constraints DIAGNOSTICS, RECOVERY_DEFAULT, RECOVERY_S2_ RESUME, 
RECOVERY _S3 RESUME, RECOVERY _S4 RESUME, RECOVERY _S5_ 
RESUME, RECOVERY FLASH UPDATE 
UNDEFINED - implies that the package creator does not know which of the boot 
modes are used. 


<SupportedBootModes> FULL RECOVERY FULL 


E | 
ee </SupportedBootModes> 


6.3.15 ModuleProperties.BootMode.HelpText 
Table 6 - 31. ModuleProperties.BootMode.HelpText 


This element specifies the HelpText describing how the module either sets or 


Description . 
P supports specific boot modes. 


Required NO 


Data Type Element — xs:string 


Data Constraints A string that contains one or more lines of text. 
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<HelpText> Initializes the Dxe Ipl PPI for all 


Examples 
7 boot modes except S3 Resume.</HelpText> 


6.3.16 ModuleProperties.BootMode.HelpText:Lang 
Table 6 - 32. ModuleProperties.BootMode.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
aig Cenetenis not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.3.17 ModuleProperties.Event 
<Event 
Usage="_UsageType " {1} 
EventType=" EventType " {1} 
SupArchList=" ArchListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
<HelpText 
Lang=""_xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</Event> 


Table 6 - 33. ModuleSurfaceArea. ModuleProperties.Event 


Description This is a list of non-GUIDed Events produced or consumed by this module. 
Required NO 
Data Type Element — Complex, nillable="true” 


Data Constraints N/A 


Examples N/A 


6.3.18 ModuleProperties.Event:Usage 
Table 6 - 34. ModuleProperties.Event:Usage 


Description This element specifies the non-GUIDed Event Usage. 


Required YES 
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Attribute — UsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 
CONSUMES or SOMETIMES PRODUCES 

PRODUCES means that a module will produce a GUID that does not fit into the 
defined PROTOCOL, PPI or other GUID types. 


CONSUMES means that a module may use this GUID that does not fit into the 
defined GUID types. 

UNDEFINED - implies that an Event is used, but the package creator does not 
know how it used. 


Usage=” PRODUCES” 
Usage=”"CONSUMES” 


6.3.19 ModuleProperties.Event:EventType 


Table 6 - 35. ModuleProperties.Event:EventType 


Description 


Required 


Data Type 


Data Constraints 


Examples 


This element specifies the type of Event. 
YES 
Attribute — UsageType 


One of the enumerated values: EVENT TYPE PERIODIC _TIMERor 
EVENT TYPE RELATIVE TIMER 

UNDEFINED - implies that an event is used, but the package creator does not 
know the Event Type. 


EventType="EVENT TYPE RELATIVE TIMER” 


6.3.20 ModuleProperties.Event:SupArchList 


Table 6 - 36. ModuleProperties.Event:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this GUID. If 
this attribute is not specified, then this GUID may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that support a 
subset of the CPU architectures specified by this element may use this GUID. 


NO 
Attribute — ArchListType 


If specified, must contain one or more of the supported CPU architectures 
separated by spaces. The supported CPU architectures include IA32, X64, IPF 
, ARM and EBC 


SupArchList=“IA32” 


SupArchList=“IA32 X64” 


SupArchList=“EBC IPF X64” 
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6.3.21 ModuleProperties.Event:FeatureFlag 


Table 6 - 37. ModuleProperties.Event:FeatureFlag 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used to restrict the use of this GUID. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. It may be an in-fix logical 
expression, evaluated left to right, for a range of values, using Relational, Equality 
and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that must 
evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
GUID may only be used if the Boolean expression evaluates to true. 


NO 
Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 
and GE. 


FeatureFlag=” true” 


6.3.22 ModuleProperties.Event.HelpText 


Table 6 - 38. ModuleProperties.Event.HelpText 


Description 


Required 
Data Type 


Data Constraints 


Examples 


This element specifies the HelpText describing how the module sets or waits for a 
timer event. 


NO 
Element -— xs:string 
A string that contains one or more lines of text. 


<HelpText> If Password is NULL unlock the 
password state variable and set the event timer. 
If the Password is too big return an error. If 
the Password is valid, copy the Password and 
enable state variable and then arm the periodic 
timer. </HelpText> 


6.3.23 ModuleProperties.Event.HelpText:Lang 


Table 6 - 39. ModuleProperties.Event.HelpText:Lang 


Description 


Required 


Data Type 


The language code uses an RFC 1766 language code identifier 
NO 


Attribute — xs:language 


- 108 - 


Chapter 6 - Module Surface Area Description 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.3.24 ModuleProperties.HOB 
<HOB 
Usage="UsageType " {1} 
HobType="HobType " {1} 
SupArchList=" ArchListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
<HelpText 
Lang=""_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</HOB> 


Table 6 - 40. ModuleSurfaceArea. ModuleProperties. HOB 


Description This is a list of non-GUIDed HOBs produced or consumed by this module. 


Required NO 
Data Type Element — Complex, nillable="true” 


Data Constraints N/A 


Examples N/A 


6.3.25 ModuleProperties.HOB:Usage 
Table 6 - 41. ModuleProperties. HOB:Usage 


Description This element specifies the HOB Usage. 
Required YES 
Data Type Attribute — UsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 
CONSUMES or SOMETIMES PRODUCES 

PRODUCES means that a module will produce a HOB that does not fit into the 
defined PROTOCOL, PPI or other GUID types. 

CONSUMES means that a module may use this HOB that does not fit into the 
defined GUID types. 

UNDEFINED - implies that a HOB is used, but the package creator does not 
know how it used. 

UNDEFINED - implies that a HOB is used, but the package creator does not 
know how itis used. 


Data Constraints 


Usage=” PRODUCES” 
Usage=”"CONSUMES” 


Examples 
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6.3.26 ModuleProperties.HOB:HobType 
Table 6 - 42. ModuleProperties. HOB :HobType 


Description This element specifies the type of HOB. 
Required YES 


Data Type Attribute — Enumerated list value 


One of the enumerated values: PHIT, MEMORY ALLOCATION, 


RESOURCE DESCRIPTOR, FIRMWARE VOLUME or LOAD _ PEIM 
UNDEFINED - implies that a HOB is used, but the package creator does not 
know the type of HOB. 


Data Constraints 


HobType=” PHIT” 


Example HobType="LOAD_PEIM” 


6.3.27 ModuleProperties.HOB:SupArchList 
Table 6 - 43. ModuleProperties.HOB:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this HOB. If this 
attribute is not specified, then this HOB may be used with any CPU Architecture. If 
this attribute is specified, then only those modules that support a subset of the CPU 
architectures specified by this element may use this GUID. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList=“IA32” 


Examples SupArchList="IA32 x64” 


6.3.28 ModuleProperties.HOB:FeatureFlag 
Table 6 - 44. ModuleProperties.HOB:FeatureFlag 


Used to restrict the use of this HOB. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
HOB may only be used if the Boolean expression evaluates to true. 


Description 
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Required NO 


Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Dat traint 
ata Constraints and GE. 


Examples FeatureFlag=” true” 


6.3.29 ModuleProperties.HOB.HelpText 
Table 6 - 45. ModuleProperties. HOB.HelpText 


Description This element specifies the HelpText describing correct usage of the HOB. 
Required NO 

Data Type Element — xs:string 

Data Constraints A string that contains one or more lines of text. 


<HelpText> This Module uses the 
gEfiHobMemoryAllocStackGuid to build a new memory 

Examples allocation HOB with old stack info with 
EfiConventionalMemory type to be reclaimed by DXE 
core. </HelpText> 


6.3.30 ModuleProperties.HOB.HelpText:Lang 
Table 6 - 46. ModuleProperties.HOB.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraint 
Consens not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.4 ModuleSurfaceArea.ClonedFrom 


The following is the description of the ModuleSurfaceArea .ClonedFronm instance: 
<ClonedFrom> 
<GUID 
Version="_ xs:decimal " {1} > 
RegistryFormatGuid 
</GUID> {1} 
</ClonedFrom> 
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6.4.1 ModuleSurfaceArea.ClonedFrom 
Table 6 - 47. ModuleSurfaceArea. ClonedFrom 


If the module sources were copied from an existing Module, then this Section can 


Recast 
eSchipion be used to track the lineage. 


Required NO 


Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.4.2 ClonedFrom.GUID 
Table 6 - 48. ClonedFrom.GUID 


If the module sources were copied from an existing Module, this is the GUID of the 
Module. 


Description 
Required YES 

Data Type Element — RegistryFormatGuid 

Data Constraints Registry format GUID of the Module this module was copied from. 


<GUID Version="2”>27d67720-ea68-48ae-93da- 


Examples a3a074c90e30</GUID> 


6.4.3 ClonedFrom.GuidValue:Version 
Table 6 - 49. ClonedFrom.GuidValue:Version 


Description This is the version of the Module that this module was copied from. 
Required YES 
Data Type Attribute — xs:decimal 


Data Constraints Version number of the existing Module 


Examples Version="1.0” 


6.5 ModuleSurfaceArea.LibraryClassDefinitions 


The following is the description of the 
ModuleSurfaceArea.LibraryClassDefinitions instance: 
<LibraryClassDefinitions> 
<LibraryClass 
Usage="" LibUsageType " {1} 
SupArchList=" ArchListType " {0,1} 
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SupModList=" ModuleListType " {0,1} 

FeatureFlag="_ xs:normalizedString " {0,1} > 
<Keyword> xs:NCName </Keyword> {1} 
<RecommendediInstance> 


<GUID 
Version="_ xs:decimal " {0,1} > 
RegistryFormatGuid 


</GUID> {1} 
</RecommendediInstance> {0,1} 
<HelpText 

Lang=""_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</LibraryClass> {1,} 
</LibraryClassDefinitions> 


Table 6 - 50. ModuleSurfaceArea.LibraryClassDefinitions 


A list the different Library Classes consumed by a driver, core and application 
module, or produced by a Library module. 


Description 


Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.5.1 LibraryClassDefinitions.LibraryClass 
Table 6 - 51. LibraryClassDefinitions.LibraryClass 
Description A Library Class 
Required YES 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.5.2 LibraryClassDefinitions.LibraryClass:Usage 
Table 6 - 52. LibraryClassDefinitions. LibraryClass:Usage 


The Usage attribute which defines whether a Library Instance might be needed by 


D ipti 
Se a the module, or if this a Library Instance for the specified LibraryClass. 


Required YES 
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Data Type Attribute — xs:NCName 


One of the enumerated values: PRODUCES, CONSUMES or SOMETIMES _ 


CONSUMES . 
UNDEFINED - implies that a library class is used, but the package creator does 
not know how it used. 


Data Constraints 


Examples Usage=” PRODUCES” 


Parameters 

CONSUMES 
The module requires one and only one library instance for the Library Class 
specified in the Keyword sub-element. 

PRODUCES 
This module is a library instance of the Library Class specified in the Keyword sub- 
element. 

SOMETIMES CONSUMES 


The module may need one and only one library instance for the Library Class 
specified in the Keyword sub-element under some conditions. 


6.5.3 LibraryClassDefinitions.LibraryClass:SupArchList 
Table 6 - 53. LibraryClassDefinitions.LibraryClass:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this Library 
Class. If this attribute is not specified, then this Library Class may be used with any 

Description CPU Architecture. If this attribute is specified, then only those modules that support 
a subset of the CPU architectures specified by this element may use this Library 
Class. 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=”"IA32” 
Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.5.4 LibraryClassDefinitions.LibraryClass:SupModList 
Table 6 - 54. LibraryClassDefinitions.LibraryClass:SupModList 
Used to restrict the set of module types that are allowed to use this Library Class. If 


Description this attribute is not specified, then this Library Class may be used with all module 
types. If this attribute is specified, then only those modules that have a module type 
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that is a member of the set of module types specified by this element may use this 
Library Class. 


Required NO 


Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 


spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 

DRIVER, DXE_SMM DRIVER, UEFI_DRIVER, UEFI_RUNTIME _ 

DRIVER, UEFI_APPLICATION, USER_DEFINED, SMM CORE. 


SupModList=” BASE” 

SupModList=”PEIM DXE_DRIVER” 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER” 


Examples 


6.5.5 LibraryClassDefinitions.LibraryClass:FeatureFlag 
Table 6 - 55. LibraryClassDefinitions.LibraryClass:FeatureFlag 


Used to restrict the use of this Library Class. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False.The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
Library Class may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=”true” 


Table 6 - 56. LibraryClassDefinitions._LibraryClass.Keyword 


Used by the UI tools to identify different instances of libraries that provide the 


D ipti 
al library class. 


Required YES 


Data Type Element — xs:NCName 


A single word that starts with an alpha character followed by one or more 
alphanumeric characters. The underscore “_” character is the only non- 


Data Constraints 
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alphanumeric character allowed. 


<Keyword>BaseMemoryLib</Keyword> 


Epamibles <Keyword>CacheMaintenanceLib</Keyword> 


6.5.6 LibraryClassDefinitions.LibraryClass.Recommendedinstance 
Table 6 - 57. LibraryClassDefinitions. LibraryClass.Recommendedinstance 


The recommended library instance as defined by the creator of the Library Class 
Header file. 


Description 
Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.5.7 LibraryClassDefinitions.LibraryClass.RecommendedInstance.GUID 
Table 6 - 58. LibraryClassDefinitions. LibraryClass.Recommendedinstance.GUID 


The GUID of the recommended library instance as defined by the creator of the 
Library Class Header file. This is a required element. If GUID is specified, and the 
Version attribute is not, then the algorithm to look up the recommended instance is 
to find the library instance highest version number and a matching GUID. 


Description 


Required YES 
Data Type Element — RegistryFormatGuid 


A string that represents a GUID in registry format. Not valid if no Recommendedinf 


Data Constraints 
attribute specified. 


Examples <GUID>AFODDA2E-EA83-480b-B2CE-FCOBB2F894C2</GUID> 


6.5.8 
LibraryClassDefinitions.LibraryClass.Recommendedinstance.GU 
ID:Version 


Table 6 - 59. LibraryClassDefinitions.LibraryClass:RecommendedInstance.GUID:Version 
The version of the recommended library instance as defined by the creator of the 


Description Library Class Header file. If this attribute is not specified, then the recommended 
library instance is the highest version number with a matching GUID. 


Required NO 
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Data Type Attribute — xs:decimal 


Data Constraints Unsigned decimal number. 


Version="1.0” 


E | 
a aa Version="2.75” 


6.5.9 LibraryClassDefinitions.LibraryClass.HelpText 
Table 6 - 60. LibraryClassDefinitions.LibraryClass.HelpText 


Used by the UI tools to provide information about this library class, it’s uses and 
functionality. 


Description 
Required NO 
Data Type Element — xs:string 


Data Constraints A string that contains one or more lines of text. 


<HelpText> Base Memory Library that uses MMX 
Examples registers for high performance. Optimized for use 
in DXE. </HelpText> 


6.5.10 LibraryClassDefinitions.LibraryClass.HelpText:Lang 
Table 6 - 61. LibraryClassDefinitions._LibraryClass.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.6 ModuleSurfaceArea.SourceFiles 


This section is required if and only if this Module is NOT a Binary Module. If this is a binary 
module, then this section is not permitted. 


The following is the description of the ModuleSurfaceArea.SourceFiles instance: 


<SourceFiles> 
<Filename 
Family=" FamilyType " {0,1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
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xs:anyURI 
</Filename> {1,} 


<HelpText 


Lang=""_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</SourceFiles> 


Table 6 - 62. ModuleSurfaceArea.SourceFiles 


Description 


Required 


Data Type 
Data Constraints 


Examples 


This element contains a list of all text-based code (including Unicode text) files that 
are included with this module. 


NO 
Element — Complex 
N/A 


N/A 


6.6.1 SourceFiles.Filename 


Table 6 - 63. SourceFiles. Filename 


Description 
Required 


Data Type 


Data Constraints 


Examples 


Source files used by tools to create binary files. 
YES 
Element — xs:anyURI 


The path (relative to the Module “root” directory) and filename of the file (as 
specified in the Distribution Content File.) 


<Filename>SwitchStack.c</Filename> 
<Filename 

SupArchList=”"1IA32”>x86LowLevel .c</Filename> 
<Filename SupArchList="1IA32”>Ia32/Non- 
existing.c</Filename> 


6.6.2 SourceFiles.Filename:Family 


Table 6 - 64. SourceFiles.Filename:Family 


Description 


Required 


The Family attribute is used to restrict usage to a given family of compilers, such as 
GCC or MSFT. Since not all code processing tools use the same syntax, especially 
for assembly, this field can be used to identify different syntax. If not specified, then 
any family can use this file. 


NO 
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Data Type Attribute — FamilyType 


Data Constraints [A-Z] [a-zA-Z0-9]* 


Family=”GCC” 


Exampl ; 
i Family="MSFT” 


6.6.3 SourceFiles.Filename:SupArchList 
Table 6 - 65. SourceFiles.Filename:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this filename. If 
this attribute is not specified, then this filename may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use this filename. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList="IA32” 
Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.6.4 SourceFiles.FileName:SupModList 


Table 6 - 66. SourceFiles.Filename:SupModList 


Used by libraries to restrict the set of module types that are allowed to use this file. 
If this attribute is not specified, then this file may be used by any module type. If this 
attribute is specified, then only those modules are in a subset of the module types 
specified by this element may use this file. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 


spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER DEFINED. 


Data Constraints 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE _ 
DRIVER" 


Examples 
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6.6.5 SourceFiles.Filename:FeatureFlag 
Table 6 - 67. SourceFiles.Filename:FeatureFlag 


Used to restrict the use of this filename. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is an in-fix logical 
expression, evaluated left to right, for a range of values, using Relational, Equality 
and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that must 
evaluate to either True or False. The form 

PcdTokenSpaceGuidC Name.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
filename may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=”true” 


6.6.6 SourceFiles.HelpText 
Table 6 - 68. SourceFiles.HelpText 


Description Used by the UI tools to provide information about source files in this module. 
Required NO 

Data Type Element -— xs:string 

Data Constraints A string that contains one or more lines of text. 


<HelpText> Sample driver using HII protocol. 


E | 
eee </HelpText> 


6.6.7 SourceFiles.HelpText:Lang 
Table 6 - 69. SourceFiles.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier. 
Required NO 
Data Type Attribute — xs:Language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is "en-us.' 


Examples Lang="en-us" 
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6.7 ModuleSurfaceArea.BinaryFiles 


If no Source Files are specified, then the files listed here will not be processed during a build. 
They are either PI FFS sections, UEFI images or Binary files. 


The following is the description of the ModuleSurfaceArea.BinaryFiles instance: 
<BinaryFiles> 
<BinaryFile> 
<Filename 
FileType=" FileType " {1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" FeatureFlagExpression " {0,1} > 
GUID="" RegistryFormatGuid " {0,1} > 
xs:anyURI 
</Filename> {1,} 
<AsBuilt> ... </AsBuilt> {0,} 
<HelpText 
Lang=""_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</BinaryFile> {1,} 
</BinaryFiles> 


Table 6 - 70. ModuleSurfaceArea.BinaryFiles 


This element contains a list of all binary files that are included with a module. If 
Description Source files have been specified, these files may be included in a module. 
Typically, this section is used for distribution of binary only code. 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.1 BinaryFiles.BinaryFile 
Table 6 - 71. BinaryFiles.BinaryFile 


Description User can enter any data that might help other developers using this source code. 
Required YES 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


- 121 - 


Chapter 6 


6.7.2 BinaryFiles.BinaryFile.Filename 


Table 6 - 72. BinaryFiles.BinaryFile.Filename 


Description Module Relative path and filename for a binary file. 


Required YES 
Data Type Element — xs:anyURI 


The path (relative to the Module’s “root” directory and filename of the file (as 


Data Constraints 
specified in the Distribution Content File.) 


<Filename 

FileType=” PE32”>SwitchStack .efi</Filename> 
<Filename SupArchList="IA32” FileType="BIN” > 
IA32/LowLevel.bin </Filename> 

<Filename FileType="BIN” SupArchList="X64"> 
X64/LowLevel.bin </Filename> 


Examples 


6.7.3 BinaryFiles.BinaryFile.Filename:FileType 
Table 6 - 73. BinaryFiles.BinaryFile.Filename:FileType 


Description Specify the type of binary file provided. 
Required YES 
Data Type Attribute — BinFileType 


One of the enumerated values: GUID, FREEFORM, UEFI_ IMAGE, PE32, 
Data Constraints PIC, PEI_DEPEX, DXE_DEPEX, TE, VER, UI, BIN, FV, SMM DEPEX ; 
COMPAT16, DISPOSABLE 


FileType=” PE32” 


i FileType="UI” 


6.7.4 BinaryFiles.BinaryFile.Filename:SupArchList 
Table 6 - 74. BinaryFiles.BinaryFile.Filename:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this filename. If 
this attribute is not specified, then this filename may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use this filename. 


Description 


Required NO 


Data Type Attribute — ArchListType 


Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 
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SupArchList=”"IA32” 


Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.7.5 BinaryFiles.FileName:SupModList 
Table 6 - 75. BinaryFiles.BinaryFile.Filename:SupModList 


Used by libraries to restrict the set of module types that are allowed to use this file. 
If this attribute is not specified, then this file may be used by any module type. If this 
attribute is specified, then only those modules are in a subset of the module types 
specified by this element may use this file. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER DEFINED. 


Data Constraints 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER" 


Examples 


6.7.6 BinaryFiles.BinaryFile.Filename:FeatureFlag 
Table 6 - 76. BinaryFiles.BinaryFile.Filename:FeatureFlag 


Used to restrict the use of this filename. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
filename may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=”PcdSupportUpdateCapsuleRest” 
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6.7.7 BinaryFiles.BinaryFile.Filename:Guid 


Table 6 - 77. BinaryFiles.BinaryFile.Filename:GUID 


An optional GUID attribute to the BinaryFiles.BinaryFile.Filename element which is 
Description only valid ifthe FileType is set to "FREEFORM", FREEFORNM is shorthand 
notation forEFI_ SECTION FREEFORM SUBTYPE GUID. 


Required NO 
Data Type Attribute — RegistryFormatGuid 


This attribute is only legal if the filename's FileType attribute is set to 


Data Constraints “FREEFORM" 


Examples GUID="964052d9-3724-4777-b220-0b42ccf7b6de" 


6.7.8 BinaryFiles.BinaryFile.AsBuilt 


If this is a binary module distribution, this section contains information about how the module was 
coded, such as Compiler Tools, Flags, PCDs (only PatchPcd, Ped and/or PedEx) and Library Class 
Instances used to build the binary. 


<AsBuilt> 

<PatchPcdValue> ... </PatchPcdValue> {0,} 

<PcdExValue> ... </PcdExValue> {0,} 

<LibraryInstances> ... </LibraryInstances> {0,1} 

<BuildFlags> Any attributes or content is permitted <BuildFlags> 
{0,} 


</AsBuilt> {0,} 
Table 6 - 78. BinaryFiles.BinaryFile.AsBuilt 


This section covers the information required by developers receiving a binary 
distribution. 'If this is a binary module distribution, this section contains information 
about how the module was coded, such as Compiler Tools, Flags, PCDs (only 
PatchPcd, Pcd and/or PcdEx) and Library Class Instances used to build the binary. 


Description 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.9 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue 
<PatchPcdValue 
PcdUsage="_ xs:NCName " {1}> 
<TokenSpaceGuidValue> RegistryFormatGuid </TokenSpaceGuidValue> {1} 
<PcdCName> xs:NCName </PcdCName> {1} 
<Token> HexNumber </Token> {1} 
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<DatumType> PcdDatumType </DatumType> {1} 

<MaxDatumSize> HexNumber </MaxDatumSize> {0,1} 

<Value> xs:normalizedString </Value> {1} 

<Offset> HexNumber </Offset> {1} 

<HelpText> ... </HelpText> {0,} 

<PedError> ... </PcedError> {0,} 

<PcdConsumesRules> PcdConsumesExpression </PcdConsumesRules> {0,} 
</PatchPcdValue> 


Table 6 - 79. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue 


An optional section that can describes any patchable PCDs that may be pertinent 
to this binary module. 


Description 


Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.10 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue:PcdUsage 
Table 6 - 80. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue:PcdUsage 


Description This attribute specifies whether the Pcd is required or produced by the module. 
Required YES 
Data Type Attribute — xs:NCName 


One of the enumerated values: CONSUMES, SOMETIMES CONSUMES, 
PRODUCES or SOMETIMES PRODUCESor UNDEFINED. 
UNDEFINED - implies that a PCD is used, but the package creator does not 
know how it used or the usage does not fit one of the other uses. . 


Data Constraints 


PcdUsage=” PRODUCES” 
PcdUsage=” CONSUMES” 


Examples 


Parameters 
CONSUMES 
This module always gets the PCD entry. 
PRODUCES 
The module always sets the PCD entry. 
SOMETIMES CONSUMES 
The module gets the PCD entry under certain conditions or execution paths. 
SOMETIMES PRODUCES 


The module gets the PCD entry under certain conditions or execution paths. 
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6.7.11 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. 
Table 6 - 81. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. TokenSpaceGuidValue 


Description The GUID value TokenSpaceGuid that defines this PCD. 


Required YES 


Data Type Element — RegistryFormatGuid 
Data Constraints Registry format GUID of the Token Space GUID. 


<TokenSpaceGuidValue> 914AEBE7-4635-459b-AA1C- 


Exaunice 11E219B03A10 </TokenSpaceGuidValue> 


6.7.12 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. Token 
Table 6 - 82. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. Token 


Description The Token Number of this PCD. 
Required YES 
Data Type Element — HexNumber 


The hex token number used during the platform build. This element must contain 


Data Constraints F ; 
one to eight hexadecimal characters. 


Examples <Token>0x00000006</Token> 


6.7.13 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdCName 
Table 6 - 83. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdCName 


Description The name of this PCD. 
Required YES 
Data Type Element — xs:NCName 


A string that starts with a letter followed by any combination of letters, digits, 


Data Constraints 
underscores, and periods. No whitespace characters are allowed. 


Examples <PcdCName> PcdDebugPrintErrorLevel </PcdCName> 


6.7.14 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.DatumType 


Table 6 - 84. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.DatumType 


Description The data type of this PCD. 
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Required YES 


Data Type Element — xs:NCName 


One of the following enumerated data types: UINT8, UINT16, UINT32, UINT64, 


Data Constraints BOOLEAN, or VOID* 


Examples <DatumType> VOID* </DatumType> 


6.7.15 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.MaxDatum Size 
Table 6 - 85. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.MaxDatumSize 


The maximum data size allocated for this PCD; this is required for VOID* Pcd 
Datum Types. 


Description 
Required NO (Depending on the PCD’s datum type) 
Data Type Element — HexNumber 


Data Constraints A hex value. 


Examples <MaxDatumSize> 0x0000001F </MaxDatumSize> 


6.7.16 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.Value 
Table 6 - 86. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. Value 


Description The value that was used at build time in the binary. 
Required YES 
Data Type Element -— xs:normalizedString 


A string that starts with a letter followed by any combination of letters, digits, 


Data Constraints 
underscores, and periods. Whitespace characters are allowed. 


Examples <Value>"en-US ; fr-FR"<Value> 


6.7.17 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.Offset 
Table 6 - 87. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. Offset 


Description The offset into the binary of this PCD. 
Required YES 
Data Type Element — HexNumber 


Data Constraints The hex address into the binary image of the PCD 


Examples <Offset> 0x00000200 </Offset> 
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6.7.18 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.HelpText 
Table 6 - 88. BinaryFiles.BinaryFile. AsBuilt.PatchPcdValue.HelpText 


Description A complete description of a how the PCD is implemented. 
Required NO 
Data Type Element -— xs:string 


Data Constraints | Astring that contains one or more lines of text. 


<HelpText> 
The PcdDebugPropertyMask is an 8-bit mask of 


debug properties that may be set to a unique 
value for each module in the platform. This PCD 
Entry is available to all CPU and Module types 
and was configured as BINARY PATCHABLE and the 
following bit settings: 

#define DEBUG PROPERTY DEBUG ASSERT ENABLED 0x01 

#define DEBUG PROPERTY DEBUG PRINT ENABLED 0x02 
</HelpText> 


Examples 


6.7.19 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.HelpText:Lang 
Table 6 - 89. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
Ble Constants not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
a ss Lang="fra” 


6.7.20 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValu 


eList 
Table 6 - 90. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValueList 


Description A list of valid values 


Required NO 


Data Type Element -— xs:normalizedString 
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Space Separated list of values. Restricted to the data type of this PCD. Use of the 
L’string” is permitted to specify a UTF-8 text string that will be converted to 
UNICODE (UCS2) formatin the code. Words that are not quoted are considered to 
be enumerations. 


Data Constraints 


<ValidValueList> 0xb0000000 0xb0000001 
</ValidValueList> 

<ValidValueList> “Blue” “Red” “White” 
</ValidValueList> 

<ValidValueList> orange peach apple pear 
</ValidValueList> 


Examples 


6.7.21 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValu 
eList:Lang 


Table 6 - 91. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValueList:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
aia Constainis not specified, the default is “en-us”. 


Lang="en-us” 


E | 
oes Lang="fra” 


6.7.22 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValu 
eRange 


Table 6 - 92. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValueRange 


Description The valid range of values using C style nomenclature. 
Required NO 
Data Type Element — xs:normalizedString 


This is required to be an in-fix logical expression, evaluated left to right, for a range 
of values, using Relational, Equality and Logical Operators (NOT, OR, AND, LT, 
LE, EQ, GT, GE and XOR) that must evaluate to either True or False. The forms 


Data Constraints PcdCName and/or PcdTokenSpaceGuidCName.PcdCName are permitted; if only 
the PcdCName is specified, then the PcdTokenSpaceGuidCName is the same as 
this PCD's TokenSpaceGuidCName. Parentheses are recommended for clarity. All 
other values must be numeric. 
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Examples 


6.7.23 


<ValidValueRange> (0xb0000000 LE PcdCNameGoesHere 
) AND (PcdCNameGoesHere GT 0x00010000) 


</ValidValueRange> 

<ValidValueRange> PcdCNameGoesHere LT 0x10001FFF 
AND (PcdCNameGoesHere NOT EQ 0x8000000) 
</ValidValueRange> 


BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.Expressi 
on 


Table 6 - 93. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.Expression 


Description 


An in-fix logical expression, evaluated left to right, using Relational, Equality and 
Logical Operators (NOT, AND, OR, GT, GE, EQ, LE, LT and XOR) and parenthesis 
are recommended. The forms PcdCName and/or 
PcdTokenSpaceGuidCName.PcdCName are permitted; if only the PcdCName is 
specified, then the PcdTokenSpaceGuidCName is the same as this PCD's 
TokenSpaceGuidCName. 


Required NO 


Data Type Element -— xs:normalizedString 


Data Constraints 


Examples 


<Expression> (NOT gPcdRecoveryMode) AND 
gPcdS3Resume </Expression> 


6.7.24 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError 


<PcdError> 


<choice> 
<ValidValueList 
Lang="_ xs:language " {0,1} > 
xs :normalizedString 
</ValidValueList> 
<ValidValueRange> xs:normalizedString </ValidValueRange> 
<Expression> xs:normalizedString </Expression> 
</choice> 
<ErrorNumber> HexNumber </ErrorNumber> {1} 
<ErrorMessage 
Lang=""_ xs:language " {0,1} > 
xs:string 
</ErrorMessage> {0,} 


</PcdError> 


Table 6 - 94. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError 
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Valid Error messages implemented in this module for the PatchPcd entry. Only 
Description One Error Number per PcdError, (multiple ErrorMessage entries are permitted) and 
multiple PcdError elements are permitted. 


Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 
6.7.25 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorNu 
mber 


Table 6 - 95. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorNumber 


Description Valid error number per specifications. 

Required YES 

Data Type Element — HexNumber 

Data Constraints A hexadecimal value for the error message as defined by specifications. 


<ErrorNumber>0xb0000000</ErrorNumber> 


Eanes <ErrorNumber>0xb0000001</ErrorNumber> 


6.7.26 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorMes 
sage 


Table 6 - 96. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorMessage 
Description An error message for conditional failures of the choices above. 
Required NO 


Data Type Element -— xs:string 


Data Constraints A string that contains one or more lines of text. 


<ErrorMessage> The value specified exceeds the 
maximum value allowed. </ErrorMessage> 


Examples 


6.7.27 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorMes 
sage:Lang 


Table 6 - 97. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorMessage:Lang 
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Description The language code uses an RFC 1766 language code identifier 


Required NO 


Data Type Attribute — xs:language 


Data Constraints 


Examples 


6.7.28 


If present, the language code must use an RFC 1766 language code identifier. If 
not specified, the default is “en-us.’ 


Lang="en-us” 
Lang="fra” 


BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdConsumesRul 
es 


Table 6 - 98. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdC onsumesRules 


Used to clarify when this this PCD is used by the binary module. This elementis a 
Boolean expression containing PCDs names, operators, and PPIs, GUIDs, and 
Protocols marked as CONSUMES or SOMETIMES_CONSUMES. This is required 
to be an in-fix logical expression, evaluated left to right, for a range of values, using 


Description Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 


and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidCName.PcdCName must be used. Parentheses are 
recommended for clarity. If the PcdConsumesExpression does not evaluate to true, 
then the value of this PCD will be ignored by the binary module 


Required NO 


Data Type Attribute — xs:normalizedString 


PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 


Data Constraints 


OR, XOR, EQ, LT, LE, GT and GE. 


<PcdConsumesRules> gEfiDevicePathProtocolGuid AND 
Examples (TokenSpaceGuid.PcdCName EQ 4) 
</PcdConsumesRules> 


6.7.29 BinaryFiles.BinaryFile.AsBuilt.PcdExValue 


<PcdExValue 


PcdUsage=" xs:NCName " {1}> 

<TokenSpaceGuidValue> RegistryFormatGuid </TokenSpaceGuidValue> {1} 
<PcdCName> xs:NCName </PcdCName> {1} 

<Token> HexNumber </Token> {1} 

<DatumType> PcdDatumType </DatumType> {1} 

<MaxDatumSize> HexNumber </MaxDatumSize> {0,1} 

<Value> xs:normalizedString </Value> {0,1} 

<HelpText> ... </HelpText> {0,} 

<PedError> ... </PcdError> {0,} 

<PcdConsumesRules> PcdConsumesExpression </PcdConsumesRules> {0,} 
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</PcdExValue> 


Table 6 - 99. BinaryFiles.BinaryFile.AsBuilt.PcdExValue 


An optional section that can describes any dynamic PCDs that may be pertinent to 
this binary module. 


Description 


Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.30 BinaryFiles.BinaryFile.AsBuilt.PcdExValue:PcdUsage 
Table 6 - 100. BinaryFiles.BinaryFile.AsBuilt.PcdExValue:PcdUsage 


Description This attribute specifies whether the Pcd is required or produced by the module. 
Required YES 
Data Type Attribute — xs:NCName 


One of the enumerated values: CONSUMES, SOMETIMES CONSUMES, 


Data Constraints PRODUCES or SOMETIMES PRODUCESor CONSUMES. 


PcdUsage=” PRODUCES” 


Ene PcdUsage=” CONSUMES” 


Parameters 
CONSUMES 
This module always gets the PCD entry. 
PRODUCES 
The module always sets the PCD entry. 
SOMETIMES CONSUMES 
The module gets the PCD entry under certain conditions or execution paths. 
SOMETIMES _ PRODUCES 


The module sets the PCD entry under certain conditions or execution paths. 


6.7.31 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdCName 
Table 6 - 101. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdCName 


Description The name of this PCD. 


Required YES 
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Data Type Element — xs:NCName 


A string that starts with a letter followed by any combination of letters, digits, 


Data Constraints 
underscores, and periods. No whitespace characters are allowed. 


Examples <PcdCName> PcdDebugPrintErrorLevel </PcdCName> 


6.7.32 BinaryFiles.BinaryFile.AsBuilt.PcdExValue. TokenSpaceGuidValue 
Table 6 - 102. BinaryFiles.BinaryFile. AsBuilt.PcdExValue. TokenSpaceGuidValue 


Description The GUID value TokenSpaceGuid that defines this PCD. 
Required YES 

Data Type Element — RegistryFormatGuid 

Data Constraints Registry format GUID of the Token Space GUID. 


<TokenSpaceGuidValue> 914AEBE7-4635-459b-AA1C- 


Examples 11E219B03A10 </TokenSpaceGuidValue> 


6.7.33 BinaryFiles.BinaryFile.AsBuilt.PcdExValue. Token 
Table 6 - 103. BinaryFiles.BinaryFile.AsBuilt.PcdExValue. Token 


Description The Token Number of this PCD. 
Required YES 
Data Type Element — HexNumber 


The hex token number used during the platform build. This element must contain 


Data Constraints 
one to eight hexadecimal characters. 


Examples <Token>0x00000006</Token> 


6.7.34 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.DatumType 
Table 6 - 104. BinaryFiles.BinaryFile.AsBuilt.PcdExValue. DatumType 


Description The data type of this PCD. 
Required YES 
Data Type Element — xs:‘NCName 


One of the following enumerated data types: UINT8, UINT16, UINT32, UINT64, 


Data Constraints BOOLEAN, or VOID* 


Examples <DatumType> VOID* </DatumType> 
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6.7.35 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.MaxDatum Size 
Table 6 - 105. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.MaxDatumSize 


The maximum data size allocated for this PCD; this is required for VOID* Pcd 


D ipti 
peer Datum Types. 


Required NO (Depending on the PCD’s datum type) 


Data Type Element — HexNumber 
Data Constraints A hex value. 


Examples <MaxDatumSize> 0x0000001F </MaxDatumSize> 


6.7.36 BinaryFiles.BinaryFile.AsBuilt.PcdExValue. Value 
Table 6 - 106. BinaryFiles.BinaryFile.AsBuilt.PcdExValue. Value 


Description The value that was used at build time in the binary. 
Required NO 
Data Type Element — xs:normalizedString 


A string that starts with a letter followed by any combination of letters, digits, 


Data Constraints 
underscores, and periods. Whitespace characters are allowed. 


Examples <Value>en-US ; fr-FR</Value> 


6.7.37 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.HelpText 
Table 6 - 107. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.HelpText 


Description A complete description of a how the PCD is implemented. 
Required NO 
Data Type Element — xs:string 


Data Constraints A string that contains one or more lines of text. 


<HelpText> Gets the base address of PCI Express. 
This internal functions retrieves PCI Express 

Examples Base Address via a PCD entry 
PcdPciExpressBaseAddress and returns the base 
address of PCI Express. </HelpText> 


6.7.38 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.HelpText:Lang 


Table 6 - 108. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.HelpText:Lang 
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Description The language code uses an RFC 1766 language code identifier 


Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
ass Lang="fra” 


6.7.39 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError 
<PcdError> 
Choice (One and only one of the following must be selected) 
<ValidvalueList 
Lang=""_ xs:language " {0,1} > 
xs:normalizedString 
</ValidValueList> 
<ValidValueRange> xs:normalizedString </ValidValueRange> 
<Expression> xs:normalizedString </Expression> 
End Choice 
<ErrorNumber> HexNumber </ErrorNumber> {1} 
<ErrorMessage 
Lang="_ xs:language " {0,1} > 
xs:string 
</ErrorMessage> {0,} 
</PcdError> 


Table 6 - 109. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError 


Valid Error messages implemented in this module for the dynamic PcdEx entry. 
Description Only One Error Number per PcdError elements (multiple ErrorMessage entries are 
permitted) and multiple PcdError elements are permitted. 


Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.40 
BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueLi 
st 


Table 6 - 110. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueList 
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Description A list of valid values 


Required NO 


Data Type Element -— xs:normalizedString 


Space Separated list of values. Restricted to the data type of this PCD. Use of the 
L”string” is permitted to specify a UTF-8 text string that will be converted to 
UNICODE (UCS2) formatin the code. Words that are not quoted are considered to 
be enumerations. 


Data Constraints 


<ValidValueList> 0xb0000000 0xb0000001 
</ValidValueList> 

<ValidValueList> “Blue” “Red” “White” 
</ValidValueList> 

<ValidValueList> orange peach apple pear 
</ValidValueList> 


Examples 


6.7.41 
BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueLi 
st:Lang 


Table 6 - 111. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueList:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
ala Constants not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
meee Lang="fra” 


6.7.42 
BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueR 
ange 


Table 6 - 112. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueRange 


Description The valid range of values using C style nomenclature. 


Required NO 


Data Type Element — xs:normalizedString 
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This is required to be an in-fix logical expression, evaluated left to right, for a range 
of values, using Relational, Equality and Logical Operators (NOT, OR, AND, LT, 
LE, EQ, GT, GE and XOR) that must evaluate to either True or False. The forms 
Data Constraints PcdCName and/or PcdTokenSpaceGuidCName.PcdCName are permitted; if only 
the PcdCName is specified, then the PcdTokenSpaceGuidCName is the same as 
this PCD's TokenSpaceGuidCName. Parentheses are recommended for clarity. All 


other values must be numeric. 


<ValidValueRange> (0xb0000000 LE PcdCNameGoesHere 
) AND (PcdCNameGoesHere GT 0x00010000) 
</ValidValueRange> 

<ValidValueRange> PcdCNameGoesHere LT 0x10001FFF 
AND (PcdCNameGoesHere NOT EQ 0x8000000) 
</ValidValueRange> 


Examples 


6.7.43 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.Expression 
Table 6 - 113. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.Expression 


An in-fix logical expression, evaluated left to right, using Relational, Equality and 
Logical Operators (NOT, AND, OR, GT, GE, EQ, LE, LT and XOR) and parenthesis 
are recommended. The forms PcdCName and/or 
PcdTokenSpaceGuidCName.PcdCName are permitted; if only the PcdCName is 
specified, then the PcdTokenSpaceGuidCName is the same as this PCD's 
TokenSpaceGuidCName. 


Description 


Required NO 
Data Type Element -— xs:normalizedString 
Data Constraints 


<Expression> (NOT gPcdRecoveryMode) AND 


Examples ' 
gPcdS3Resume </Expression> 


6.7.44 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorNumber 
Table 6 - 114. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorNumber 


Description Valid error number per specifications. 
Required YES 


Data Type Element — HexNumber 


Data Constraints A hexadecimal value for the error message as defined by specifications. 


<ErrorNumber>0xb0000000</ErrorNumber> 


eure <ErrorNumber>0xb0000001</ErrorNumber> 
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6.7.45 
BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorMessa 


ge 


Table 6 - 115. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorMessage 


Description An error message for conditional failures of the choices above. 


Required NO 
Data Type Element -— xs:string 
Data Constraints A string that contains one or more lines of text. 


<ErrorMessage> The value specified exceeds the 


Examples 
° maximum value allowed. </ErrorMessage> 


6.7.46 
BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorMessa 


ge:Lang 
Table 6 - 116. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorMessage:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
ee Lang="fra” 


6.7.47 BinaryFiles.BinaryFile.AsBuilt.Librarylnstances 
<LibraryInstances> 
<GUID 
Version=" xs:decimal " {1} > 
RegistryFormatGuid 
</GUID> {1,} 
</LibraryInstances> 


Table 6 - 117. BinaryFiles.BinaryFile.AsBuilt.Librarylnstances 


This section is used to define the Library Class Instances that were linked to the 


Description Module.. 


Required yes 
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Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.48 BinaryFiles.BinaryFile.AsBuilt.Librarylnstances.GUID 
Table 6 - 118. BinaryFiles.BinaryFile.AsBuilt.LibraryInstances:GUID 


Description The Registry Format GUID of the library Instance. 
Required YES 

Data Type Element — RegistryFormatGuid 

Data Constraints A string that represents a GUID in registry format. 


Examples <GUID>£d44e603-002a-4b29-9£5£-529e815b6165</GUID> 


6.7.49 BinaryFiles.BinaryFile.AsBuilt.LibraryInstances.GUID:Version 
Table 6 - 119. BinaryFiles.BinaryFile.AsBuilt.Librarylnstances:Version 


Description The Version Number of the Library Instance. 
Required NO 

Data Type Attribute — xs:decimal 

Data Constraints A decimal number 


Examples Version="1.0” 


6.7.50 BinaryFiles.BinaryFile.AsBuilt.BuildFlags 
Table 6 - 120. BinaryFiles.BinaryFile.AsBuilt.BuildFlags 


This section shows the build tool flags that were used during the creation of the 
module. Of specific interest are flags that define values on the compiler command 
line, as well as possible optimizations. Any Attributes to this element are also 
permitted. 


Description 


Required NO 
Data Type Element — Complex, mixed="true" 


Data Constraints None — any attributes and/or content 


<BuildFlags MSVS="8.0”> 
Examples /EXPORT: InitializeDriver=§ (IMAGE _ENTRY_POINT) 
/ALIGN: 4096 /SUBSYSTEM:CONSOLE </BuildFlags> 
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6.7.51 BinaryFiles.BinaryFile.HelpText 
Table 6 - 121. BinaryFiles.BinaryFile.HelpText 


Used by the UI tools to provide information about a binary file's use and 


D ipti 
poe functionality. 


Required NO 


Data Type Element -— xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText> Sample driver using HII protocol. 


E | 
meee </HelpText> 


6.7.52 BinaryFiles.BinaryFile.HelpText:Lang 
Table 6 - 122. BinaryFiles.BinaryFile.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier. 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is "en-us. 


Examples Lang="en-us" 


6.7.53 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdConsumesRules 
Table 6 - 123. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdConsumesRules 


Used to clarify when this this PCD is used by the binary module. This elementis a 
Boolean expression containing PCDs names, operators, and PPIs, GUIDs, and 
Protocols marked as CONSUMES or SOMETIMES_CONSUMES. This is required 
to be an in-fix logical expression, evaluated left to right, for a range of values, using 

Description Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidC Name.PcdCName must be used. Parentheses are 
recommended for clarity. Ifthe PcdConsumesExpression does not evaluate to true, 
then the value of this PCD will be ignored by the binary module. 


Required NO 


Data Type Attribute — xs:normalizedString 


PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 


Data Constraints | GR XOR, EQ, LT, LE, GT and GE. 


Ce 
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<PcdConsumesRules> gEfiDevicePathProtocolGuid AND 


Examples (TokenSpaceGuid.PcdCName EQ 4) 
</PcdConsumesRules> 


6.8 ModuleSurfaceArea.PackageDependencies 


The following is the description of the ModuleSurfaceArea.PackageDependencies instance: 
<PackageDependencies> 
<Package 

SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag="_ xs:normalizedString " {0,1} > 

<Description 

Lang="" xs:language " {0,1}> 
xs:string 
</Description> {0,} 


<GUID 
Version="_xs:decimal " {0,1} > 
RegistryFormatGuid 


</GUID> {1} 
</Package> {1,} 
</PackageDependencies> 


Table 6 - 124. ModuleSurfaceArea. PackageDependencies 


Description This element contains a list of all packages a module depends on. 


Required NO 


Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.8.1 PackageDependencies.Package 
Table 6 - 125. PackageDependencies. Package 


Description This Broriey specifies a package required by this module to properly build or 
function. 

Required YES 

Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.8.2 PackageDependencies.Package:SupArchList 
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Table 6 - 126. PackageDependencies.Package:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this package. If 
this attribute is not specified, then this package may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use this package. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=”"IA32” 
Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.8.3 PackageDependencies.Package:SupModList 
Table 6 - 127. PackageDependencies. Package:SupModList 


Used by libraries to restrict the set of module types that are allowed to use this 
package dependency. If this attribute is not specified, then this package 

Description dependency may be used by any module type. If this attribute is specified, then 
only those modules are in a subset of the module types specified by this element 
may use this package dependency. 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, 

Data Constraints PEIM, DXE_CORE,DXE_ DRIVER, DXE_ RUNTIME DRIVER, DXE _ 
SAL_DRIVER, DXE_SMM_ DRIVER, TOOL, UEFI_DRIVER, UEFI_ 
RUNTIME DRIVER, UEFI_APPLICATION, USER DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE _ 
DRIVER" 


Examples 


6.8.4 PackageDependencies.Package:FeatureFlag 
Table 6 - 128. PackageDependencies.Package:FeatureFlag 


Used to restrict the use of this package. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 


Description 
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must evaluate to either True or False. The form 

PcdTokenSpaceGuidC Name.PcdCName is required.. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
package may only be used if the Boolean expression evaluates to true. 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=”"true” 


6.8.5 PackageDependencies.Package.Description 
Table 6 - 129. PackageDependencies.Package.Description 


Description This element describes the reason for the dependency. 
Required NO 

Data Type Element -— xs:string 

Data Constraints A string that contains one or more lines of text. 


<Description> Requires Status Code Library 


Examples ; : : 
Functions </Description> 


6.8.6 PackageDependencies.Package.Description:Lang 
Table 6 - 130. PackageDependencies.Package.Description:Lang 


Description The language code uses an RFC 1766 language code identifier. 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraint 
aes not specified, the default is "en-us. 


Examples Lang="en-us" 


6.8.7 PackageDependencies.Package.GUID 
Table 6 - 131. PackageDependencies.Package.GUID 


Description The language code uses an RFC 1766 language code identifier. 


Required NO 
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Data Type Element — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is "en-us. 


Examples Lang="en-us" 


6.8.8 PackageDependencies.Package.GUID:Version 
Table 6 - 132. PackageDependencies. Package.GUID:Version 


This attribute specifies the version of a package required by this module to 
properly build or function. If this attribute is listed, ONLY the specific GUID/Version 
package can be used. If this attribute is not specified, the highest version ofa 
package can be used. 


Description 


Required NO 


Data Type Attribute — xs:decimal 


Data Constraints [0-9]+((\.)?[0-9}+)* 


Version="1.0” 


E | : 
eae Version="1.10” 


6.9 ModuleSurfaceArea.Guids 


It is permissible for a module to list a GUID twice, once for CONSUMES and another for 
PRODUCES, if and only if the GUID type is transformed by the module. 


The following is the description of the ModuleSurfaceArea . Guids instance: 
<Guids> 
<GuidCName> ... </GuidCName> {1,} 
</Guids> 


<GuidCName 
Usage="UsageType " {1} 
GuidType=" GuidListType " {1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
<CName> xs:NCName </CName> {1} 
<GUID> RegistryFormatGuid </GUID> {0,1} 
<VariableName> xs:normalizedString </VariableName> {0,1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
<SometimesConsumes> ConsumesExpression 
</SometimesConsumes> {0,} 
</GuidCName> 
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Table 6 - 133. ModuleSurfaceArea. Guids 


Description This is a list of Guids produced or consumed by this module. 


Required NO 


Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.9.1 Guids.GuidCName 
Table 6 - 134. Guids.GuidCName 


This element specifies information about Guids used by, or produced by this 
Description module. The GUID CName specified in this section must be defined in a package 
declaration. Protocols and PPls do not need to be listed in this section. 


Required YES 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.9.2 Guids.GuidCName:Usage 
Table 6 - 135. Guids.GuidCName:Usage 


Description This element specifies the GUID Usage. 
Required YES 
Data Type Attribute -— UsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 
CONSUMES or SOMETIMES PRODUCES 

PRODUCES means that a module will produce a GUID that does not fit into the 
defined PROTOCOL or PPI types. 

CONSUMES means that a module may use this GUID that does not fit into the 
defined PROTOCOL or PPI types. 

UNDEFINED - implies that a GUID is used, but the package creator does not 
know how it used. 


Data Constraints 


Usage=” PRODUCES” 
Usage=”"CONSUMES” 


Examples 
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Parameters 
CONSUMES 
The module will use the named GUID. For GUID type (specified in the Type 
attribute) of: 


e Event - CONSUMES means that the module has an event waiting to be signaled (i.e., the 
module registers a notification function and calls the function when it is signaled. 


System Table - this means that the module will use a GUIDed entry in the system 
table. 


¢ EFI Variable - this means that the module may use the variable entry. 
¢ Formset - the formset may be registered into HII by this module. 


* TokenSpaceGuid - this means that an Token Space GUID will be required for PCD 
entries used in this module. 


¢ Hob - this means that a HOB may need to be present in the system. 


¢ File/FV - this means that a file must be present in an FV, such as a module that loads a 
processor microcode patch file. 


¢ GUID - this means that a module may use this GUID that does not fit into the defined 
GUID types. 


PRODUCES 
This module always produces a named GUID. For GUID type (specified in the 
Type attribute) of: 
* Boot Modes - this means that the module will change the boot mode. 
¢ Event - this means that module will signal all events in an event group. 


¢ System Table - this means that the module will produce a GUIDed entry in the system 
table. 


¢ EFI Variable - this means that the module will write the variable. 
* Formset - PRODUCES is not valid for this GUID type. 

¢ TokenSpaceGuid - PRODUCES is not valid for this GUID type. 
¢ Hob - this means that the HOB will be produced by the module. 


¢ File/FV - this means that a module creates a file that is present in an FV, such as a file 
that contains a microcode patch. 


¢ GUID - this means that a module will produce a GUID that does not fit into the defined 
PROTOCOL, PPI or GUID types. 


6.9.1 Guids.GuidCName:GuidType 
Table 6 - 136. Guids.GuidCName:GuidType 


Description This element specifies the type of GUID. 


Required YES 


Data Type Attribute — GuidListType 


Data Constraints One or more of the enumerated values: Event, File, FV, GUID, HII, HOB, 
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SystemTable, TokenSpaceGuid or Variable. 
UNDEFINED - implies that a GUID is used, but the package creator does not 
know the GUID's type. 


GuidType="Event” 
GuidType=”TokenSpaceGuid” 


Examples 


Parameters 
Fivent 


The functions that make up the Event used during preboot to create, close, signal, 
and wait for events as defined in the UEFI specification. 


SystemTable 


As defined in the PI Specification, the UEFI System Table is passed to every 
executable image in the DXE phase. The UEFI System Table contains a pointer to 
the following: 


"UEFI Boot Services Table" 
"UEFI Runtime Services Table" 


It also contains pointers to the console devices and their associated I/O protocols. In 
addition, the UEFI System Table contains a pointer to the UEFI Configuration 
Table, which contains a list of GUID/pointer pairs. The UEFI Configuration Table 
may include tables such as the "DXE Services Dependencies", HOB list, ACPI 
table, SMBIOS table, and SAL System table. 
The UEFI Boot Services Table contains services to access the contents of the 
handle database. The handle database is where protocol interfaces produced by 
drivers are registered. Other drivers can use the UEFI Boot Services to look up 
these services produced by other drivers. 

Variable 


The UEFI and PI specifications define UEFI Variables as key/value pairs that 
consist of identifying information plus attributes (the key) and arbitrary data (the 
value). Variables are intended for use as a means to store data that is passed 
between the UEFI environment implemented in the platform and UEFI OS loaders 
and other applications that run in the UEFI environment. 


Hit 
These GUIDs refer to the core code and services that are required for an 
implementation of the Human Interface Infrastructure (HII). 

TokenSpaceGuid 
These GUIDs are used as a definition of a group of Platform Configuration 
Database (PCD) entries. Different packages of PCDs are identified by a Token 
Space GUID. Within each of these packages, the individual PCD's Token number is 
unique. PCDs are then identified by the Token Space GUID and the PCD's Token 
number. 


HOB 
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These GUIDs are for manipulation of the PEI-DXE Hand Off Blocks. The HOB 
types are defined in the PI Specification. 


GUID 


These are GUIDs that do not fall into PPI, PROTOCOL or any of the above 
definitions. 


6.9.2 Guids.GuidCName:SupArchList 
Table 6 - 137. Guids.GuidCName:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this GUID. If 
this attribute is not specified, then this GUID may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use this GUID. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=“IA32” 
Examples SupArchList=“IA32 X64” 
SupArchList=“EBC IPF X64” 


6.9.3 Guids.GuidCName:SupModList 
Table 6 - 138. Guids.GuidCName:SupModList 


Used by libraries to restrict the set of module types that are allowed to use this 
guid. If this attribute is not specified, then this guid may be used by any module 
type. If this attribute is specified, then only those modules are in a subset of the 
module types specified by this element may use this guid. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 


spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_ SAL _ 

DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI __ 

RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER" 


Examples 


6.9.4 Guids.GuidCName:FeatureFlag 


- 149 - 


Chapter 6 


Table 6 - 139. Guids.GuidCName:FeatureFlag 


Used to restrict the use of this GUID. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False.The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
GUID may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints 
and GE. 


Examples FeatureFlag=” true” 


6.9.5 Guids.GuidCName.CName 
Table 6 - 140. Guids.GuidCName.CName 


Description This element specifies the C name of the GUID. 
Required YES 

Data Type Element — xs:NCName 

Data Constraints Must be a valid GUID C name 


<CName> gEfiEventReadyToBootGuid </CName> 


Ese <CName>gEfiConsoleInDeviceGuid</CName> 


6.9.6 Guids.GuidCName.VariableName 
Table 6 - 141. Guids.GuidCName.VariableName 


Description This element specifies the Variable name for a Variable GUID. 
Required NO 
Data Type Element -— xs:normalizedString 


Must be a valid Variable Name in either Hex Array (litle endian) or L’string” (C 


Data Constraint 
cai ad style.) This elementis only valid for an EFI Variable GUID type. 


<VariableName> L”Reset” </VariableName> 
Examples <VariableName> 0x52 0x00 0x65 0x00 0x73 0x00 0x65 
0x00 0x74 0x00 </VariableName> 
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6.9.7 Guids.GuidCName.GUID 
Table 6 - 142. Guids.GuidCName.GUID 


Description This element specifies the GUID value of a GUID. 


Required NO 


Data Type Element — RegistryFormatGuid 
Data Constraints Registry format GUID of a GUID. 


<GUID>5e0e9358-46b6-4ae2-8218 -4ab8b9bbdcec</GUID> 


ExemipIes <GUID>b6ec423c-21d2-490d-85c6-dd5864eaa674</GUID> 


6.9.8 Guids.GuidCName.HelpText 
Table 6 - 143. Guids.GuidC Name. HelpText 


Description This element specifies the HelpText describing correct usage of the GUID 
Required NO 

Data Type Element -— xs:string 

Data Constraints A string that contains one or more lines of text. 


<HelpText> Check the device handle, if it isa 
hot plug device, do not put the device path into 
ConInDev, and install gEfiConsoleInDeviceGuid to 
the device handle directly. 

The policy is, make hot plug device plug in and 
play immediately. </HelpText> 


Examples 


6.9.9 Guids.GuidCName.HelpText:Lang 
Table 6 - 144. Guids.GuidCName.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints . ; 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.9.10 Guids.GuidCName.SometimesConsumes 


Table 6 - 145. Guids.GuidCName.SometimesConsumes 
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Used to clarify when this this GUID is consumed by the driver. This elementis a 
Boolean expression containing PCDs names, operators, and PPIs, GUIDs, and 
Protocols marked as CONSUMES or SOMETIMES_ CONSUMES. This is required 
to be an in-fix logical expression, evaluated left to right, for a range of values, using 

Description Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidC Name.PcdCName must be used. Parentheses are 
recommended for clarity. Each SometimesConsumes expression must evaluate to 
true for this module to function. 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 


Dat traint 
ata Constraints | oR xOR, EQ, LT, LE, GT and GE. 


<SometimesConsumes> gEfiDevicePathProtocolGuid 
Examples AND (TokenSpaceGuid.PcdCName EQ 4) 
</SometimesConsumes> 


6.10 ModuleSurfaceArea.Protocols 


The following is the description of the ModuleSurfaceArea. Protocols instance: 
<Protocols> 
<Protocol 
Usage="" ProtocolUsageType " {1} 
Notify="_xs:boolean " {0,1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag="_ xs:normalizedString " {0,1} > 
<CName> xs:NCName </CName> {1} 
<GUID> RegistryFormatGuid </GUID> {0,1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
<ByStart> ByStartExpression </ByStart> {0,} 
<SometimesConsumes> ConsumesExpression 
</SometimesConsumes> {0,} 
</Protocol> {1,} 
</Protocols> 


Table 6 - 146. ModuleSurfaceArea.Protocols 


Description This element contains a list of all Protocols a module depends on or produces. 


Required NO 


Data Type Element — Complex 
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Data Constraints N/A 


Examples N/A 


6.10.1 Protocols.Protocol 
Table 6 - 147. Protocols.Protocol 


This element specifies information about a Protocol used or produced by this 
Description module. The CName specified in this section must be defined in a package 
declaration. 


Required YES 
Data Type Element — ComplexType 
Data Constraints Only child elements are allowed within the element 


Examples N/A 


6.10.2 Protocols.Protocol:Usage 
Table 6 - 148. Protocols.Protocol:Usage 


Description This attribute specifies whether the Protocol is needed or produced by the module. 
Required YES 
Data Type Attribute — ProtocolUsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 


CONSUMES, SOMETIMES PRODUCES, TO START orBY_ START. 
UNDEFINED - implies thata Protocol is used, but the package creator does not 
know how it used. 


Data Constraints 


Usage=” PRODUCES” 


Exampl 
ae Usage=”CONSUMES” 


Parameters 
CONSUMES 


This module does not install the protocol, but needs to locate a protocol. Not valid if 
the Notify attribute is true. 
PRODUCES 
This module will install this protocol. Not valid if the Notify attribute is true. 
SOMETIMES CONSUMES 
This module does not install the protocol, but may need to locate a protocol under 
certain conditions, (such as if it is present.) If the Notify attribute is set, then the 
module will use the protocol, named by GUID, via a registry protocol notify 
mechanism. 
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SOMETIMES PRODUCES 
This module will install this protocol under certain conditions. Not valid if the Notify 
attribute is true. 

TO_START 
The protocol is consumed by a Driver Binding protocol Start function. Thus the 


protocol is used as part of the UEFI driver model. Not valid if the Notify attribute is 
true. 


BY START 


The protocol is produced by a Driver Binding protocol Start function. Thus the 
protocol is used as part of the UEFI driver model. Not valid if the Notify attribute is 
true. 


6.10.3 Protocols.Protocol:Notify 
Table 6 - 149. Protocols.Protocol:Notify 
This attribute specifies whether this is a Protocol or ProtocolNotify. If set, then the 


Description module will use this protocol, named by GUID, via a registry protocol notify 
mechanism. 


Required NO 


Data Type Attribute — xs:boolean 


Only required for ProtocolNotify, in which the value must be set to true. The default 


Data Constraints 
(non-specified) value is false. 


Examples Notify="true” 


6.10.4 Protocols.Protocol:SupArchList 
Table 6 - 150. Protocols.Protocol:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this protocol. If 
this attribute is not specified, then this protocol may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that support a 
subset of the CPU architectures specified by this element may use this protocol. 


Description 


Required NO 
Data Type Attribute — ArchListType 


Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=‘“IA32” 
Examples SupArchList=“IA32 X64” 
SupArchList=“EBC IPF X64” 


6.10.5 Protocols.Protocol:SupModList 
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Table 6 - 151. Protocols.Protocol:SupModList 


Used by libraries to restrict the set of module types that are allowed to use this 
guid. If this attribute is not specified, then this guid may be used by any module 
type. If this attribute is specified, then only those modules are in a subset of the 
module types specified by this element may use this guid. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL _ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER" 


Examples 


6.10.6 Protocols.Protocol:FeatureFlag 
Table 6 - 152. Protocols.Protocol:FeatureFlag 


Used to restrict the use of this protocol. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidCName.PcdCName must be used. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
protocol may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Dat traint 
ata Constraints and GE. 


Examples FeatureFlag=”"false” 


6.10.7 Protocols.Protocol.CName 


Table 6 - 153. Protocols.Protocols.CName 


Description This element specifies the C name of the Protocol. 
Required YES 
Data Type Element — xs:NCName 
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Data Constraints Must be a valid GUID C name 


<CName>gEfiBlockIoProtocolGuid</CName> 


ExeInples <CName> gEfiBlockIoProtocolGuid </CName> 


6.10.8 Protocols.Protocol.GUID 
Table 6 - 154. Protocols.Protocol.GUID 


Description This element specifies the GUID value of a Protocol. 


Required NO 


Data Type Element — RegistryFormatGuid 


Data Constraints Registry format GUID of a Protocol. 


<GUID>5e0e9358-46b6-4ae2-8218 -4ab8b9bbdcec</GUID> 


exaliplcs <GUID>b6ec423c-21d2-490d-85c6-dd5864eaa674</GUID> 


6.10.9 Protocols.Protocol.HelpText 
Table 6 - 155. Protocols.Protocol.HelpText 


Description This element specifies the HelpText describing correct usage of the Protocol 
Required NO 

Data Type Element -— xs:string 

Data Constraints A string that contains one or more lines of text. 


<HelpText> The Block I/O Protocol provides 
services to read, write, and flush block to a 
block oriented storage device such as a hard 
Examples disk, CD-ROM, DVD, and floppy. This Protocol is 
available to all CPU types, but is restricted for 
use by DXE_DRIVER, UEFI_DRIVER, and UEFI_ 
APPLICATION module types. </HelpText> 


6.10.10 Protocols.Protocol.HelpText:Lang 
Table 6 - 156. Protocols.Protocol.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 


Required NO 
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Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.10.11 Protocols.Protocol.ByStart 
Table 6 - 157. Protocols.ProtocolByStart 


This element is only used if the Usage attribute is BY_START. 
Used to clarify the requirements to produce this protocol in the driver's Driver 
Binding protocol Start function. This element is a Boolean expression containing 
PCDs names, Protocols marked as TO_START for this module, and operators. This 
is required to be an in-fix logical expression, evaluated left to right, for a range of 
Description values, using Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, 
EQ, GT, GE and XOR) that must evaluate to either True or False. To specify a PCD, 
the form PcdTokenSpaceGuidCName.PcdCName must be used. Parentheses are 
recommended for clarity. If the usage attribute is BY_START and there is at least 
one ByStart element then the protocol will be produced BY_START only if at least 
one ByStart element expression evaluates to true. 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators: NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


<ByStart> gEfiDevicePathProtocolGuid AND 
Examples (gE£fiUsb2HcProtocolGuid OR gEfiUsbHcProtocolGuid) 
</ByStart> 


6.10.12 Protocols.Protocol.SometimesProduces 
Table 6 - 158. Protocols.Protocol.SometimesProduces 


Used to clarify when this this protocol, which must be marked with usage of 
SOMETIMES_PRODUCED, is produced by the driver. This element is a Boolean 
expression containing PCDs names, operators, and PPls, GUIDs, and Protocols 
marked as CONSUMES or SOMETIMES_CONSUMES. This is required to be an 
in-fix logical expression, evaluated left to right, for a range of values, using 
Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidCName.PcdCName must be used. Parentheses are 
recommended for clarity. If any SometimesProduces expression evaluates to true, 
then this protocol is produced. 


Description 
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Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 


Data Constraints | GR XOR, EO, LT, LE, GT and GE. 


<SometimesConsumes> gEfiDevicePathProtocolGuid 
Examples AND (TokenSpaceGuid.PcdCName EQ 4) 
</SometimesProduces> 


6.11 ModuleSurfaceArea.PPIs 


The following is the description of the ModuleSurfaceArea. PPIs instance: 
<PPIs> 
<Ppi 
Usage="" UsageType " {1} 
Notify=""xs:boolean " {0,1} 
SupArchList=" ArchListType " {0,1} 
SupModList_” ModuleListType “ {0,1} 
FeatureFlag="xs:normalizedString " {0,1} > 
<CName> xs:NCName </CName> {1} 
<GUID> RegistryFormatGuid </GUID> {0,1} 
<HelpText 
Lang=""_xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
<SometimesConsumes> ConsumesExpression 
</SometimesConsumes> {0,} 
</Ppi> {1,} 
</PPIs> 


Table 6 - 159. ModuleSurfaceArea.PPlIs 


Description This element contains a list of all PPIs a module depends on or produces. 


Required NO 


Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.11.1 PPls.Ppi 
Table 6 - 160. PPls.Ppi 


This element specifies the C name of a Ppi required by this module to properly 
build or function, or produced by this module. 


Description 
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Required YES 


Data Type Element — ComplexType 


Data Constraints N/A 


Examples N/A 


6.11.2 PPls.Ppi:Usage 
Table 6 - 161. PPls.Ppi:Usage 


Description This attribute specifies whether the Ppi is required or produced by the module. 
Required YES 
Data Type Attribute - UsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 


CONSUMES or SOMETIMES PRODUCES. 
UNDEFINED - implies thata PPlis used, but the package creator does not know 
how it used. 


Data Constraints 


Usage=” PRODUCES” 


Examples Usage=”"CONSUMES” 


Parameters 
CONSUMES 


This module does not install the PPI, but needs to locate a PPI. Not valid if the 
Notify attribute is true. 


PRODUCES 

This module will load this PPI. Not valid if the Notify attribute is true. 
SOMETIMES CONSUMES 

This module does not install the PPI, but may need to locate a PPI under certain 


conditions or execution paths. If the Notify attribute is set, then the module will use 
the PPI, named by GUID, via a registry PPI notify mechanism. 


SOMETIME PRODUCES 


This module will load this PPI under certain conditions or execution paths. Not valid 
if the Notify attribute is true. 


6.11.3 PPls.Ppi:Notify 


Table 6 - 162. Ppis.Ppi:Notify 


This attribute specifies whether this is a Ppi or PpiNotify. If set to, the module 


D ipti 
a a requires or consumes a PPI, named by GUID, via a register PPI notify mechanism. 
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Required 


Data Type 


Data Constraints 


Examples 


NO 
Attribute — xs:boolean 


Only required for PpiNotify, in which the value must be set to true. The default (non- 
specified) value is false. 


Notify="true” 


6.11.4 PPls.Ppi:SupArchList 


Table 6 - 163. PPIls.Ppi:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this Ppi. If this 
attribute is not specified, then this Ppi may be used with any CPU Architecture. If 
this attribute is specified, then only those modules that support a subset of the CPU 
architectures specified by this element may use this Ppi. 


NO 
Attribute — ArchListType 
[A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList=“IA32” 
SupArchList=“IA32 X64” 
SupArchList=“EBC IPF X64” 


6.11.5 PPIs.Ppi:SupModList 


Table 6 - 164. PPIs.Ppi:SupModList 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used by libraries to restrict the set of module types that are allowed to use this ppi. 
If this attribute is not specified, then this ppi may be used by any module type. If this 
attribute is specified, then only those modules are in a subset of the module types 
specified by this element may use this ppi. 


NO 
Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 


spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL _ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE__ 
DRIVER" 
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6.11.6 PPls.Ppi:FeatureFlag 


Table 6 - 165. PPls.Ppi:FeatureFlag 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used to restrict the use of this Ppi. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this Ppi 
may only be used if the Boolean expression evaluates to true. 


NO 
Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 
and GE. 


FeatureFlag=”" false” 


6.11.7 PPls.Ppi.CName 


Table 6 - 166. PPls.Ppi.CName 


Description This element specifies the C name of the Ppi. 

Required YES 

Data Type Element — xs:NCName 

Data Constraints Must be a valid C name. 

exsiipiés <CName>gEfiDxeIp1PpiGuid</CName> 
<CName>gEfiPeiStallPpiGuid</CName> 

6.11.8 PPls.Ppi.GUID 


Table 6 - 167. PPls.Ppi.GUID 


Description 
Required 
Data Type 


Data Constraints 


Examples 


This element specifies the GUID value of a Ppi. 
NO 
Element — RegistryFormatGuid 


Registry format GUID of a Ppi. 


<GUID>5e0e9358-46b6-4ae2-8218 -4ab8b9bbdcec</GUID> 
<GUID>b6ec423c-21d2-490d-85c6-dd5864eaa674</GUID> 


6.11.9 PPls.Ppi.HelpText 
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Table 6 - 168. PPls.Ppi.HelpText 


Description 


Required 


Data Type 


Data Constraints 


Examples 


This element specifies the HelpText describing correct usage of the Ppi 
NO 

Element -— xs:string 

A string that contains one or more lines of text. 


<HelpText> The Block I/O Ppi provides services to 
read, write, and flush block to a block oriented 
storage device such as a hard disk, CD-ROM, DVD, 
and floppy. This Ppi is available to all CPU 
types, but is restricted for use by DXE_ DRIVER, 
UEFI_DRIVER, and UEFI_APPLICATION module 

types .</HelpText> 


6.11.10 PPls.Ppi.HelpText:Lang 


Table 6 - 169. PPIs.Ppi.HelpText:Lang 


Description 
Required 


Data Type 


Data Constraints 


Examples 


The language code uses an RFC 1766 language code identifier 
NO 
Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 
not specified, the default is “en-us.’ 


Lang="en-us” 


6.11.11 PPls.Ppi.SometimesConsumes 


Table 6 - 170. Guids.GuidCName.SometimesConsumes 


Description 


Required 


Data Type 


Used to clarify when this this PPI is consumed by the driver. This elementis a 
Boolean expression containing PCDs names, operators, and PPIs, GUIDs, and 
Protocols marked as CONSUMES or SOMETIMES_CONSUMES. This is required 
to be an in-fix logical expression, evaluated left to right, for a range of values, using 
Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidCName.PcdCName must be used. Parentheses are 
recommended for clarity. Each SometimesConsumes expression must evaluate to 
true for this module to function.n. 


NO 


Attribute — xs:normalizedString 
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PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 


Dat fraint 
ata Constraints | oR XOR, EQ, LT, LE, GT and GE: 


<SometimesConsumes> gEfiDevicePathProtocolGuid 
Examples AND (TokenSpaceGuid.PcdCName EQ 4) 
</SometimesConsumes> 


6.12 ModuleSurfaceArea.Externs 


The following is the description of the ModuleSurfaceArea.Externs instance: 
<Externs> 
<Extern 
SupArchList=" ArchListType " {0,1} 
SupModList=” ModuleListType “ {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
Start Choice 
Start Sequence 
<EntryPoint> xs:NCName </EntryPoint> {0,1} 
<UnloadImage> xs:NCName </UnloadImage> {0,1} 
End Sequence 
Start Sequence 
<Constructor> xs:NCName </Constructor> {0,1} 
<Destructor> xs:NCName </Destructor> {0,1} 
End Sequence 
End Choice 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</Extern> {1,} 
</Externs> 


Table 6 - 171. ModuleSurfaceArea.Externs 


Description This section defines additional information about dirvers and libraries. 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.12.1 Externs.Extern 


Table 6 - 172. Externs.Extern 
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Description 
Required 


Data Type 
Data Constraints 


Examples 


These elements specify multiple setions of additional information. 


YES 
Element — Complex 


Multiple Instances of Extern Statements are permitted, and atleast one of the 
following sub-elements must be specified. 


N/A 


6.12.2 Externs.Extern:SupArchList 


Table 6 - 173. Externs.Extern:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this Extern. If 
this attribute is not specified, then this Extern may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use this Extern. 


NO 
Attribute — ArchListType 
[A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList="IA32” 
SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.12.3 Externs.Extern:SupModList 


Table 6 - 174. Externs.Extern:SupModList 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used to restrict the set of module types that are allowed to use this Extern. If this 
attribute is not specified, then this Extern may be used with any module type. If this 
attribute is specified, then only those modules that support a subset of the module 
types specified by this element may use this Extern. 


NO 
Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE _ 
DRIVER" 
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6.12.4 Externs.Extern:FeatureFlag 
Table 6 - 175. Externs.Extern:FeatureFlag 


Used to restrict the use of this Extern. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False.The form 

PcdTokenSpaceGuidC Name.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
Extern may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=”"true” 


6.12.5 Externs.Extern.EntryPoint 
Table 6 - 176. Externs.Extern.EntryPoint 


This element specifies the Module Entry Point of the Module. C name of the 
Description module entry point function. The PE32 image entry point goes into a library and the 
library calls this entry pointin the module. 


Required NO 
Data Type Element — xs:NCName 
Data Constraints Must be a valid C name. Valid for drivers only. 


<EntryPoint> GenericMemoryTestEntryPoint 
Examples </EntryPoint> 
<EntryPoint>BarEntry</Entry Point 


6.12.6 Externs.Extern.Unloadimage 
Table 6 - 177. Externs.Extern.Unloadimage 


This element specifies the Module Unload Image of the Module. C name of the 
Description module unload function. This function is optional as a module is not required to 
support unload. 


Required NO 


Data Type Element — xs:NCName 
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Data Constraints Must be a valid C name. Valid for drivers only. 


<UnloadImage>FooUnload</UnloadImage> 


Examines <UnloadImage>BarUnload</UnloadImage> 


6.12.7 Externs.Extern.Constructor 
Table 6 - 178. Externs.Extern.C onstructor 


This element specifies the Constructor of a Library. While most library instances do 
not produce Constructors, those that do, should include the C name here. Library 

Description constructors are called before the module entry point function is executed. Any 
library that performs initialization (such as the Dxe SMM report status code library) 
should publish a constructor. 


Required NO 
Data Type Element — xs:NCName 
Data Constraints Must be a valid C name. Valid for a Library Module 


<Constructor>BarInit</Constructor> 


E | : 
Aol <Constructor>FooInit</Constructor> 


6.12.8 Externs.Extern.Destructor 
Table 6 - 179. Externs.Extern.Destructor 


This element specifies the Destructor of a Library. While most library instances do 
not produce Destructors, those that do, should include the C name here. Library 

Description destructors are called after the module entry point function is executed. Any library 
that performs a cleanup (such as the UEFI Runtime library) should publish a 
destructor. 


Required NO 
Data Type Element — xs:NCName 
Data Constraints Must be a valid C name. Valid for a Library Module 


<Destructor>BarkKill</Destructor> 


E | sj 
a aa <Destructor>Fookill</Destructor> 


6.12.9 Externs.Extern.HelpText 
Table 6 - 180. Externs.Extern.HelpText 


This element specifies the HelpText describing the module EntryPoint, 
UnloadImage, Constructor or Destructor. 


Description 
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Required NO 


Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText> GenericMemoryTestEntryPoint is the 
generic memory test driver's entry point, it can 
initialize private data 

to default value. </HelpText> 


Examples 


6.12.10 Externs.Extern.HelpText:Lang 
Table 6 - 181. Externs.Extern.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.13 ModuleSurfaceArea.PcdCoded 


Note that if the Binary attribute was set for the ModuleSurfaceArea, then only include the PCDs 
that are of type: PatchPcd, Pcd and/or PcdEx. The "DefaultValue" becomes the real value used 
during the build of the module in the context of a platform and must be set. The PcdItemType must 
be set to the way the platform used the PCD. If a binary is present, along with the sources, and the 
Binary attribute is NOT set, then this is a standard section, and the Pcd sections of the AsBuilt 
must be used to show how the binary was created. 


The following is the description of the ModuleSurfaceArea .PcdCoded instance: 


<PcdCoded> 
<PcdEntry 
PcdItemType="" PcdItemTypes " {1} 
PcdUsage="_ xs:NCName " {1} 
SupArchList=" ArchListType " {0,1} 
SupModList=” ModuleListType “ {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
<CName> xs:NCName </CName> {1} 
<TokenSpaceGuidCName> xs:NCName </TokenSpaceGuidCName> {1} 
<DefaultValue> xs:normalizedString </DefaultValue> {0,1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
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<PcdConsumesRules> PcdConsumesExpression 
</PcedConsumesRules> {0,} 
</PedEntry> {1,} 
</PcdCoded> 


Table 6 - 182. ModuleSurfaceArea.PcdC oded 


Description The list of PCDs the module was coded to use. 


Required NO 


Data Type Element - Complex 
Data Constraints N/A 


Examples N/A 


6.13.1 PcdCoded.PcdEntry 


Table 6 - 183. ModuleSurfaceArea.PcdCoded.PcdEntry 


Description Defines how the module was coded for this PCD Entry. 
Required YES 

Data Type Element - Complex 

Data Constraints N/A 

Examples N/A 


6.13.2 PcdCoded.PcdEntry:PcditemType 
Table 6 - 184. PcdCoded.PcdEntry:PcdltemType 
Description Define the PCD type for this entry. 
Required YES 
Data Type Attribute — PcdltemTypes 


Must contain one of the following Enumerated Data Types: FeaturePcd, 


Dat traint 
af Constalbits FixedPcd, PatchPcd, Pcd or PcdEx. 


PcdI temType="FixedPcd” 
Examples PcditemType="FixedPcd PatchPcd” 
PcdItemType=”Pcd” 


Parameters 


FeaturePcd 


The FeaturePcd is used as a boolean flag to enable or disable specific features. 
FixedPcd 


The FixedPcd is used to flag the platform integrator that the module requires a static 
mapping of the PCD. 
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PatchPcd 
The PatchPcd is used to flag the platform integrator that the module requires a 
mapping of the PCD where the value can be altered in the binary (the value needs to 
be a known offset,, with information about data size and type available. 


Ped 
The Pcd is used to flag the platform integrator that the module may be used as a 
Fixed Pcd, Patch Ped, or a Dynamic PCD - where the value is registered in a PCD 
database within the system and the value can be found/set using either a PCD PPI or 
PCD Protocol driver. The platform integrator should select how he wants to use the 
PCD. 

PcdEx 


The PcdEx is used to flag the platform integrator that the module is coded for a 
Dynamic PCD - where the value is registered in a PCD database within the system 
and the value can be found/set using either a PCD PPI or PCD Protocol driver. 


6.13.3 PcdCoded.PcdEntry:PcdUsage 
Table 6 - 185. PcdCoded.PcdEntry:PcdUsage 


Description This attribute specifies whether the Pcd is required or produced by the module. 
Required YES 
Data Type Attribute — xs:‘NCName 


One of the enumerated values: CONSUMES, SOMETIMES CONSUMES, 


PRODUCES or SOMETIMES PRODUCES. For PcditemTypes of FeatureFlag, 
Data Constraints this entry mustbe CONSUMES. 

UNDEFINED - implies thata PCD is used, but the package creator does not 

know how it used. 


PcdUsage=” PRODUCES” 


Esmee PcdUsage=” CONSUMES” 


Parameters 
CONSUMES 
This module always gets the PCD entry. 
PRODUCES 
The module always sets the PCD entry. 
SOMETIMES CONSUMES 
The module gets the PCD entry under certain conditions or execution paths. 
SOMETIMES _ PRODUCES 


The module sets the PCD entry under certain conditions or execution paths. 


6.13.4 PcdCoded.PcdEntry:SupArchList 
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Table 6 - 186. PcdCoded.PcdEntry:SupArchLis 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this PCD. If this 
attribute is not specified, then this PCD may be used with any CPU Architecture. If 
this attribute is specified, then only those modules that support a subset of the CPU 
architectures specified by this element may use this PCD. 


NO 
Attribute — ArchListType 
[A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList="IA32” 
SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.13.5 PcdCoded.PcdEntry:SupModList 


Table 6 - 187. PcdCoded.PcdEntry:SupModLis 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used by libraries to restrict the set of module types that are allowed to use this pcd. 
If this attribute is not specified, then this pcd may be used by any module type. If 
this attribute is specified, then only those modules are in a subset of the module 
types specified by this element may use this pcd. 


NO 
Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE _ 
DRIVER" 


6.13.6 PcdCoded.PcdEntry:FeatureFlag 


Table 6 - 188. PcdCoded.PcdEntry:FeatureFlag 


Description 


Used to restrict the use of this PCD. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The forms PcdCName and/or 
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PcdTokenSpaceGuidCName.PcdCName are permitted; if only the PcdCName is 
specified, then the PcdTokenSpaceGuidCName is the same as this PCD's 
TokenSpaceGuidCName. Parentheses are recommended for clarity. If this attribute 
is specified, then this PCD may only be used if the Boolean expression evaluates 
to true. 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=”"true” 


6.13.7 PcdCoded.PcdEntry.CName 
Table 6 - 189. PcdCoded.PcdEntry.CName 


Description This element specifies the C name of the PCD entry 

Required YES 

Data Type Element — xs:NCName 

Data Constraints A valid C name listed in a declaration file that declares the PCD. 


<CName>PcdMaximumUnicodeStringLength</CName> 


amples <CName> PcdMaximumAsciiStringLength </CName> 


6.13.8 PcdCoded.PcdEntry. TokenSpaceGuidCName 
Table 6 - 190. PcdCoded.PcdEntry. TokenSpaceGuidC Name 


This element specifies the C name of the PCD defined TokenSpaceGuidCName. 
Description The actual GUID value must be declared in a package declaration file that may not 
be part of this distribution. 


Required YES 
Data Type Element — xs:NCName 


Data Constraints 


<TokenSpaceGuidCName> gEfiMdePkgTokenSpaceGuid 
</TokenSpaceGuidCName> 


Examples 


6.13.9 PcdCoded.PcdEntry.DefaultValue 


Table 6 - 191. PcdCoded.PcdEntry.DefaultValue 
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Description 


Required 


Data Type 


Data Constraints 


Examples 


This element specifies the C name of the PCD defined TokenSpaceGuidCName 
NO 

Element — xs:normalizedString 

Any valid string of printable characters. 


<DefaultValue>0x0048 0x0052</DefaultValue> 
<DefaultValue>LBigBear</DefaultValue> 


6.13.10 PcdCoded.PcdEntry.HelpText 


Table 6 - 192. PcdCoded.PcdEntry.HelpText 


Description 


Required 
Data Type 


Data Constraints 


Examples 


This element specifies the HelpText describing how the module was coded for this 
PCD 


NO 
Element — xs:string 
A string that contains one or more lines of text. 


<HelpText> This module uses the FixedPcd: 
PcdDxeIp1SwitchToLongMode to compute the top of 
the stack we were allocated, which is used to 
load X64 dxe core. 

Pre-allocate a 32 bytes which conforms to x64 
calling convention. 

The first four parameters to a function are 
passed in rex, rdx, r8 and r9. Any further 
parameters are pushed on the stack. Furthermore, 
space (4 * 8bytes) for the register parameters is 
reserved on the stack, in case the called 
function wants to spill them; this is important 
if the function is variadic. </HelpText> 


6.13.11 PcdCoded.PcdEntry.HelpText:Lang 


Table 6 - 193. PcdCoded.PcdEntry.HelpText:Lang 


Description 
Required 


Data Type 


Data Constraints 


Examples 


The language code uses an RFC 1766 language code identifier 
NO 
Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 
not specified, the default is “en-us.’ 


Lang="en-us” 
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6.13.12 PcdCoded.PcdEntry.PcdConsumesRules 
Table 6 - 194. PcdCoded. PcdEntry.PcdConsumesRules 


Used to clarify when this this PCD is used by the module. This elementis a 
Boolean expression containing PCDs names, operators, and PPls, GUIDs, and 
Protocols marked as CONSUMES or SOMETIMES_CONSUMES. This is required 
to be an in-fix logical expression, evaluated left to right, for a range of values, using 

Description Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidCName.PcdCName must be used. Parentheses are 
recommended for clarity. Ifthe PcdConsumesExpression does not evaluate to true, 
then the value of this PCD will be ignored by the module. 


Required NO 
Data Type Element -— xs:normalizedString 


PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 


Data Constraints | GR XOR, EQ, LT, LE, GT and GE. 


<PcdConsumesRules> gEfiDevicePathProtocolGuid AND 
Examples (TokenSpaceGuid.PcdCName EQ 4) 
</PcdConsumesRules> 


6.14 ModuleSurfaceArea.PeiDepex 


The following is the description of the ModuleSurfaceArea.PeiDepex instance: 

<PeiDepex 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1}> 
<Expression> xs:string </Expression> {1} 
<HelpText 

Lang=""_ xs:language " {0,1} > 
xs:normalizedString 

</HelpText> {0,1} 

</PeiDepex> 


Table 6 - 195. ModuleSurfaceArea. PeiDepex 


Description This describes the PEIM dependency expression. 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.14.1 PeiDepex:SupArchList 
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Table 6 - 196. PeiDepex:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this 
dependency expression. If this attribute is not specified, then this dependency 
expression may be used with any CPU Architecture. If this attribute is specified, 
then only those modules that support a subset of the CPU architectures specified 
by this element may use this dependency expression. 


NO 
Attribute - ArchListType 
[A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList="IA32" 
SupArchList="IA32 X64" 
SupArchList="EBC IPF X64" 


6.14.2 PeiDepex:SupModList 


Table 6 - 197. PeiDepex:ModArchList 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used by libraries to restrict the set of module types that are allowed to use this 
dependency expression. If this attribute is not specified, then this dependency 
expression may be used by any module type. If this attribute is specified, then only 
those modules are in a subset of the module types specified by this element may 
use this dependency expression. 


NO 
Attribute - ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER" 


6.14.3 PeiDepex:FeatureFlag 


Table 6 - 198. PeiDepex:FeatureFlag 


Description 


Used to restrict the use of this dependency expression. This attribute is a Boolean 
expression containing PCD Feature Flag names and operators. This is an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
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Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute 

is specified, then this dependency expression may only be used if the Boolean 
expression evaluates to true. 


Required NO 
Data Type Attribute - xs:normalizedString 


PCD C names, true, false and/or Operators: NOT, AND, OR, XOR, EQ, LT, LE, 


Dat traint 
ata Constraints GT andGE. 


Examples FeatureFlag="true" 


6.14.4 PeiDepex.Expression 
Table 6 - 199. PeiDepex.Expression 


This is a string contains valid dependency expression, processed left to right. Tools 
may use this data to create a PE] Depex section. The GUID value associated with 
the C name can be found by searching the GUID declarations in the package 
surface area. 


Description 


Required YES 
Data Type Element — xs:normalizedString 


Data Constraints A single line that will be used to generate a PEI dependency section. 


gEfiPeiMemoryDiscoveredPpiGuid OR 
gEfiTemporaryRamSupportPpiGuid 


Examples 


6.14.5 PEIM Dependency Expression Grammar 


The expression must conform to the following grammar. 
Note: Future releases of PI specification may take precedence over this grammar): 


<PeiDepex> ::= | <bool> 

<bool> = <bool> AND <term> 
| <bool> OR <term> 
| <term> 

<term> = NOT <factor> 
| <factor> 

<factor> = <bool> 

| TRUE 

| FALSE 

| <GUID> 

| 


END 
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<GUID> ::= {<RegistryFormatGuid>} {<GuidCName>} 
PeiDepex.HelpText 


6.14.1 PeiDepex.HelpText 
Table 6 - 200. PeiDepex.HelpText 


This element specifies the HelpText describing why this PEI Depex is required for 


D ipti 
a cca the module. 


Required NO 


Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText> This module required the following. 
Examples </ 
HelpText> 


6.14.2 PeiDepex.HelpText:Lang 
Table 6 - 201. PeiDepex.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.15 Module SurfaceArea.DxeDepex 


The following is the description of the ModuleSurfaceArea .DxeDepex instance: 

<DxeDepex 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1}> 
<Expression> xs:string </Expression> {1} 
<HelpText 

Lang=""_ xs:language " {0,1} > 
xs :normalizedString 

</HelpText> {0,1} 

</DxeDepex> 


Table 6 - 202. ModuleSurfaceArea.DxeDepex 
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Description This describes the DXE driver dependency expression. 


Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.15.1 DxeDepex:SupArchList 
Table 6 - 203. DxeDepex:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this 
dependency. 


Description 
Required NO 

Data Type Attribute — ArchListType 

Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList="IA32" 
Examples SupArchList="IA32 X64" 
SupArchList="EBC IPF X64" 


6.15.2 DxeDepex:SupModList 
Table 6 - 204. DxeDepex:SupModList 


Used by libraries to restrict the set of module types that are allowed to use this 
dependency expression. If this attribute is not specified, then this dependency 

Description expression may be used by any module type. If this attribute is specified, then only 
those modules are in a subset of the module types specified by this element may 
use this dependency expression. 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION 
DXE_DRIVER" 


Examples 
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6.15.3 DxeDepex:FeatureFlag 
Table 6 - 205. DxeDepex:FeatureFlag 


Used to restrict the use of this dependency expression. This attribute is a Boolean 
expression containing PCD Feature Flag names and operators. This is an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
Description must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 
Parentheses are recommended for clarity. If this attribute is specified, then this 
dependency expression may only be used if the Boolean expression evaluates to 
true. 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag="true" 


6.15.4 DxeDepex.Expression 
Table 6 - 206. DxeDepex.Expression 


This is a string contains valid dependency expression, processed left to right. Tools 
may use this data to create a Dxe Depex section.The GUID value associated with 
the C name can be found by searching the GUID declarations in the package 
surface area. 


Description 


Required YES 
Data Type Element -— xs:normalizedString 


Data Constraints A single line that will be appended to a flag line for the tool code entered. 


gEfiFirmwareVolumeBlockProtocolGuid AND 
Examples gEfiAlternateFvBlockGuid AND 
gEfiFaultTolerantWriteLiteProtocolGuid 


6.15.4.1 DXE Dependency Expression Grammar 


The Expression must conform to the following grammar (note that future releases of PI 
Specification may take precedence over this grammar): 


<DxeDepex> = BEFORE <guid> 
| AFTER <guid> 
| SOR <bool> 
| <bool> 
<bool> = <bool> AND <term> 
| 


<bool> OR <term> 
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<term> 

NOT <factor> 
<factor> 
<bool> 


| 
<term> = 
| 
| TRUE 
| 
| 
| 


<factor> 
FALSE 
GUID 


END 


<guid> {<RegistryFormatGuid>} {<GuidCName>} 


6.15.5 DxeDepex.HelpText 
Table 6 - 207. DxeDepex.HelpText 


This element specifies the HelpText describing why this DXE depex is required for 
the module. 


Description 


Required NO 
Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText> This module required the following. 


E I 
mene </HelpText> 


6.15.6 DxeDepex.HelpText:Lang 
Table 6 - 208. DxeDepex.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.16 Module SurfaceArea.SmmDepex 


The following is the description of the ModuleSurfaceArea. SmmDepex instance: 
<SmmDepex 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1}> 
<Expression> xs:string </Expression> {1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs :normalizedString 
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</HelpText> {0,1} 


</SmmDepex> 


Table 6 - 209. ModuleSurfaceArea.SmmDepex 


Description 
Required 

Data Type 

Data Constraints 


Examples 


This describes the SMM (DXE) driver dependency expression. 


NO 
Element — Complex 
N/A 


N/A 


6.16.1 SmmDepex:SupArchList 


Table 6 - 210. SmmDepex:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this 
dependency expression. If this attribute is not specified, then this dependency 
expression may be used with any CPU Architecture. If this attribute is specified, 
then only those modules that support a subset of the CPU architectures specified 
by this element may use this dependency expression. 


NO 
Attribute - ArchListType 
[A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList="IA32" 
SupArchList="IA32 X64" 
SupArchList="EBC IPF X64" 


6.16.2 SmmDepex:SupMod List 


Table 6 - 211. SmmDepex:SupModList 


Description 


Required 


Data Type 


Data Constraints 


Used by libraries to restrict the set of module types that are allowed to use this 
dependency expression. If this attribute is not specified, then this dependency 
expression may be used by any module type. If this attribute is specified, then only 
those modules are in a subset of the module types specified by this element may 
use this dependency expression. 


NO 


Attribute - ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
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DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER" 


Examples 


6.16.3 SmmDepex:FeatureFlag 
Table 6 - 212. SmmDepex:FeatureFlag 


Used to restrict the use of this dependency expression. This attribute is a Boolean 
expression containing PCD Feature Flag names and operators. This is an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
Description must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 
Parentheses are recommended for clarity. If this attribute is specified, then this 
dependency expression may only be used if the Boolean expression evaluates to 
true. 


Required NO 
Data Type Attribute - xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag="true" 


6.16.4 SmmDepex.Expression 
Table 6 - 213. SmmDepex.Expression 


This is a string contains valid dependency expression, processed left to right. Tools 
may use this data to create a SMM (Dxe) Depex section. The GUID value 
associated with the C name can be found by searching the GUID declarations in 
the package surface area. 


Description 


Required YES 
Data Type Element -— xs:normalizedString 


Data Constraints A single line that will be appended to a flag line for the tool code entered. 


gEfiFirmwareVolumeBlockProtocolGuid AND 
Examples gEfiAlternateFvBlockGuid AND 
gEfiFaultTolerantWriteLiteProtocolGuid 


6.16.4.1 SMM Dependency Expression Grammar 
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The Expression must conform to the following grammar. 
Note: Future releases of PI specification may take precedence over this grammar): 


<SmmDepex> = BEFORE <guid> 
| AFTER <guid> 
| SOR <bool> 
| <bool> 
<bool> = <bool> AND <term> 
| <bool> OR <term> 
| <term> 
<term> ::= NOT <factor> 
| <factor> 
= <bool> 
| TRUE 
| FALSE 
| GUID 
| END 


{<RegistryFormatGuid>} {<GuidCName>} 


<factor> 


<guid> 


6.16.1 SmmDepex.HelpText 
Table 6 - 214. SmmDepex.HelpText 


This element specifies the HelpText describing why this SMM depex is required for 
the module. 


Description 


Required NO 
Data Type Element -— xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText> This module required the following. 


E | 
Sentee </HelpText> 


6.16.2 SmmDepex.HelpText:Lang 
Table 6 - 215. SmmDepex.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 
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6.17 ModuleSurfaceArea.MiscellaneousFiles 


The following is the description of the ModuleSurfaceArea .MiscellaneousFiles 
instance: 
<MiscellaneousFiles> 
<Description 
Lang=""xs:language " {0,1} 
xs:string 
</Description> {0,} 
<Filename 
Executable=" xs:boolean " {0,1} 
xs: anyURI 
</Filename> {1,} 
</MiscellaneousFiles> 


Table 6 - 216. ModuleSurfaceArea. MiscellaneousFiles 


This element contains any module specific miscellaneous files not defined 
previously. 


Description 


Required NO 
Data Type Element — Complex 


Data Constraints Free-form text or any well formed XML element(s.) 


Examples N/A 


6.17.1 MiscellaneousFiles.Description 
Table 6 - 217. MiscellaneousFiles.Description 


Description Any information that might be appropriate for files listed in this section. 
Required NO 

Data Type Element -— xs:string 

Data Constraints A string that contains one or more lines of text. 


<Description> Readme.txt is a quick start guide 


Examples 
for using this module. </Description> 


6.17.2 MiscellaneousFiles. Description:Lang 


Table 6 - 218. MiscellaneousFiles. Description:Lang 


Description 


Required 


Data Type 


The language code uses an RFC 1766 language code identifier 
NO 


Element — xs:language 
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If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is "en-us.' 


Examples Lang="en-us" 


6.17.3 MiscellaneousFiles.Filename 


Table 6 - 219. MiscellaneousFiles.Filename 


A file that is included in the distribution package that does not pertain to any of the 


Description 
: previously defined sections. 


Required NO 


Data Type Element — xs:anyURI 


The path and filename of the file, relative to the Module’s “root” directory (as 


Data Constraints 
specified in theDistribution Content File.) 


<File>FooBarMfgBuildReadMe. txt</File> 


Examples <File> Specs/FooBar_ Rules.pdf </File> 


6.17.4 Misc.Filename:Executable 
Table 6 - 220. Misc.Filename:Executable 


Description This flag is used during installation to ensure that the file is executable. 
Required NO 
Data Type Attribute — xs:boolean 


Data Constraints “true’ or “false” (default) 


Examples Executable=”true” 


6.18 ModuleSurfaceArea.UserExtensions 


The following is the description of the ModuleSurfaceArea.UserExtensions instance: 
<UserExtensions 
UserId=" xs:NCName " {1} 
Identifier="_xs:string " {1} 
AnyAttribute {0,} > 
Mixed Content, any user defined elements are also permitted. 
Any Text or XML Format 
</UserExtensions> 


Table 6 - 221. ModuleSurfaceArea.UserExtensions 


Description This section is used for any processing instructions that may be custom to the 
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content provided by the distribution that are common to module. 

The content is vendor specific. 

The content can be plain text as well as any user-defined, properly formatted XML 
structure 


Required NO 
Data Type Element — Complex 


Data Constraints None 


Examples N/A 


6.18.1 UserExtensions:Userld 
Table 6 - 222. UserExtensions:Userld 


Description The normative reference name to identify the originator of this information. 
Required YES 
Data Type Attribute — xs:NCName 


A string that starts with a letter followed by any combination of letters, digits, 


Data Constraints 
underscores, and periods. No whitespace characters are allowed. 


Name="NoSuchCorp” 


Examples Name=”" FooBarMfg” 


6.18.2 UserExtensions:I|dentifier 
Table 6 - 223. UserExtensions:Identifier 


Description The string reference identify this information. 
Required YES 
Data Type Attribute— xs:normalizedString 


A string that starts with a number or a letter followed by any combination of letters, 


Data Constraints 
digits, underscores, dashes and periods. Whitespace characters are allowed. 


Name="Special Build Rules 1" 
Name="£6665cf£5-8290-4b02-ba0c-5cb5a9542176" 


Examples 
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Chapter 6 - 
Module Surface Area Description 


A distribution surface area may contain zero or more Module Surface Area sections. Within the 
Module Surface Area only the attributes and the Header section are required. The remaining 
sections are optional. 


The XML Instance Representation for DistributionPackage .ModuleSurfaceArea is 
as follows: 
<ModuleSurfaceArea 
BinaryModule=" xs:boolean " {0,1} > 
<Header> ... </Header> {1} 
<ModuleProperties> ... </ModuleProperties> {0,1} 
<ClonedFrom> ... </ClonedFrom> {0,1} 
<LibraryClassDefinitions> ... </LibraryClassDefinitions> {0,1} 
<SourceFiles> ... </SourceFiles> {0,1} 
<BinaryFiles> ... </BinaryFiles> {0,1} 
<PackageDependencies> ... </PackageDependencies> {0,1} 
<Guids> ... </Guids> {0,1} 
<Protocols> ... </Protocols> {0,1} 
<PPIs> ... </PPIs> {0,1} 
<Externs> ... </Externs> {0,1} 
<PcedCoded> ... </PcdCoded> {0,1} 
<PeiDepex> ... </PeiDepex> {0,} 
<DxeDepex> ... </DxeDepex> {0,} 
<SmmDepex> ... </SmmDepex> {0,} 
<MiscellaneousFiles> ... </MiscellaneousFiles> {0,1} 
<UserExtensions> ... </UserExtensions> {0,} 
</ModuleSurfaceArea> 


Table 6 - 1. ModuleSurfaceArea 


Description Specifies contents of a Module that is provided by this distribution package. 
Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.1 ModuleSurfaceArea:BinaryModule 


Table 6 - 2. ModuleSurfaceArea:BinaryModule 
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This attribute is used when the binaries are distributed for this module and no code 
Description generation from source files is required. If set, then the binary section should be 
used, and any files listed in the SourceFiles section do not have to be built. 


Required NO 
Data Type Attribute — xs:boolean 


For binary only modules, this value should be set to “true”, Default (or non- 


Data Constraints . 
specified) value is “false’. 


Examples BinaryModule=”"true” 


6.2 ModuleSurfaceArea.Header 


The following is the description of the ModuleSurfaceArea. Header instance: 
<Header> 
<BaseName> 
xs :Nmtoken 
</BaseName> {1} 
<Name 
Lang=""_ xs:language " {0,1} > 
xs :normalizedString 
</Name> {1,} 


<GUID 
Version=""xs:decimal " {1} > 
RegistryFormatGuid 


</GUID> {1} 
<Copyright> xs:string </Copyright> {0,1} 
<License> xs:string </License> {0,1} 
<Abstract 
Lang=""_ xs:language " {0,1} > 
xs:normalizedString </Abstract> {0,} 
<Description 
Lang="_ xs:language " {0,1} > 
xs:string </Description> {0,} 
</Header> 


Table 6 - 3. ModuleSurfaceArea. Header 


This element contains the header information for Module Surface Area Description. 
This includes the name of the module, descriptions of the module, copyright and 
licensing information associated with the module, and the version of XML Schema 
to which this file conforms. 


Description 


Required YES 


Data Type Element — Complex 
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Data Constraints N/A 


Examples N/A 


6.2.1 Header.Name.BaseName 
Table 6 - 4. Header.Name:BaseName 


This is a single word BaseName that may be used to create output file names and 


Description 
P directories. 


Required YES 


Data Type Attribute - xs:Nmtoken 


It must be a word made up of one or more alphanumeric characters. Non-word 
Data Constraints characters: underscore "_", dash "-", and period"." are permitted after the first 
character. 


BaseName=”IntelIch7” 


E | 
oon BaseName="Foo_bar-1_ ten” 


6.2.2 Header.Name 
Table 6 - 5. Header.Name 


Besedsten The User Interface Name for the module. This name is only used by a user 
° interface to display the name of the module. 

Required YES 

Data Type Element -— xs:normalizedString 


Data Constraints String value of one or more characters. 


Examples <Name> USB 1.0 I/O Driver </Name> 


6.2.3 Header.Name:Lang 
Table 6 - 6. HeaderName:Lang 


Description The language code uses an RFC 1766 language code identifier. 
Required NO 
Data Type Attribute - xs:language 


If present, the language code must use an RFC1766 language code identifier. If 


Data Constraint 
a senna not specified, the default is “en-us.’ 


Lang="en-us” 
Lang="fra” 


Examples 
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6.2.4 Header.Name.BaseName 
Table 6 - 7. Header.Name:BaseName 


This is a single word BaseName that may be used to create output file names and 


Description . : 
P directories. 


Required YES 


Data Type Attribute - xs:Nmtoken 


It must be a word made up of one or more alphanumeric characters. Non-word 
Data Constraints characters: underscore "_", dash "-", and period"." are permitted after the first 
character. 


BaseName="IntelIch7” 


Examples 
BaseName="Foo_bar-1_ ten” 


6.2.5 Header.GUID 
Table 6 - 8. Header.GUID 


The 128-bit registry format GUID that is the unique name of a module. The GUID 


Description 
P must change if a change is made that is not backward compatible. 


Required YES 
Data Type Element — RegistryFormatGuid 


A string that represents a GUID in registry format. 
Ifa module is backwards compatible with a previous release of the same module, 
then ModuleSurfaceArea.Header.GUID element must not be 

Data Constraints changed, and only the 
ModuleSurfaceArea.Header .GUID: Version element should be 
increased. If a module is not backward compatible with a previous release, then a 
new ModuleSurfaceArea .Header .GUID must be generated. 


<GUID Version="0.3”> AFODDA2E-EA83-480b-B2CE- 


Examples FCOBB2F894C2 </GUID> 


6.2.6 Header.GUID:Version 
Table 6 - 9. Header.GUID:Version 


Description The version of this Module. 


Required YES 


Data Type Attribute — xs:decimal 


Data Constraints A string that contains a positive decimal number with a dot separator. 
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Examples 


Version="1.00” 


Version="1.02” 
Version="3.27” 


6.2.7 Header.Copyright 


Table 6 - 10. Header.Copyright 


Description 


Required 
Data Type 


Data Constraints 


Examples 


This field is require only if the copyright of this module is different from the 
copyright of the container package that provides this module. The copyright for this 
module that is generated by the creator of a module. If a derivative work is 
generated from an existing module, then the existing copyright must be 
maintained, and additional copyrights may be appended to the end of this element. 


NO 
Element -— xs:string 
A set of one or more copyright statements on one or more lines of text. 


<Copyright> 

Copyright (c) 2006, Nosuch Corporation. All 
rights reserved. 

</Copyright> 


6.2.8 Header.License 


Table 6 - 11. Header.License 


Description 


Required 
Data Type 


Data Constraints 


Examples 


This field is only required if the module license is different from the container 
package license. A license that describes any restrictions on the use of this 
module. If a derivative work is allowed by the original license and a derivative work 
is generated from an existing module, then the existing license must be 
maintained, and additional licenses may be appended to the end of this element. 
Alternative, this may point to a file which is located in the same directory a the 
module description file. 


NO 
Element — xs:string 
A string that contains one or more lines of text. 


<License> 

This program and the accompanying materials are 
licensed and made available under the terms and 
conditions of the BSD License which accompanies 
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this distribution. The full text of the license 


may be found at: 
http: //opensource.org/licenses/bsd-license.php 
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE 


ON AN AS IS BASIS, WITHOUT WARRANTIES OR 
REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR 
IMPLIED. 

</License> 

<License> License.txt </License> 


6.2.9 Header.Abstract 
Table 6 - 12. Header.Abstract 


Description Aone line description of the module. 
Required NO 

Data Type Element -— xs:normalizedString 

Data Constraints String value of one or more characters. 


Examples <Abstract> USB I/O Driver Version 1.0 </Abstract> 


6.2.9.1 Header.Abstract:Lang 
Table 6 - 13. Header.Abstract:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
le aa Lang="fra” 


6.2.10 Header.Description 
Table 6 - 14. Header.Description 


A complete description of the module. This description must include the release 
name of the module, the version of the module, and a complete description of the 
module contents and/or features including a description of the updates since the 
previous module release. 


Description 
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Required NO 


Data Type Element — xs:string 


Data Constraints A string that contains one or more lines of text. 


<Description> 
USB I/O Driver Version 1.0 that conforms to the 


Examples USB 2.2 specification. The module handles all USB 


I/O functions. 
</Description> 


6.2.10.1 Header:Description:Lang 
Table 6 - 15. Header.Description:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 


Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code 
identifier. If not specified, the default is “en-us.” 


Data Constraints 


Lang="en-us” 
Examples 


Lang="fra” 


6.3 ModuleSurfaceArea.ModuleProperties 


The following is the description of the ModuleSurfaceArea.ModuleProperties 
instance: 
<ModuleProperties 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} > 
<ModuleType> ModuleTypes </ModuleType> {1} 
<Path> xs:anyURI </Path> {1} 
<PcdIsDriver> PcdDriverTypes </PcdIsDriver> {0,1} 


<UefiSpecificationVersion> xs:decimal </UefiSpecificationVersion> 


{0,1} 

<PiSpecificationVersion> xs:decimal </PiSpecificationVersion> 
{0,1} 

<Specification 

Version=" xs:decimal " > 
xs :NCName 

</Specification> {0,} 

<BootMode> ... </BootMode> {0,} 

<Event> ... </Event> {0,} 

<HOB> ... </HOB> {0,} 
</ModuleProperties> 
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Table 6 - 16. ModuleSurfaceArea.ModuleProperties 


List general information about a module, including the Supported Architectures, 
the version of the UEFI and PI specs a module may conform to, and non-GUIDed 
information, such as boot modes a module might set, timer events, or hand off 
blocks. 


Description 


Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.3.1 ModuleProperties:SupArchList 
Table 6 - 17. ModuleProperties:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this module. If 
this attribute is not specified, then this module may be used with any CPU 
Architecture. If this attribute is specified, then only those platforms that support a 
subset of the CPU architectures specified by this element may use this module. 
The list of Architectures that this module was designed to support and that ithas 
been tested on. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList="IA32” 
Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.3.2 ModuleProperties:SupModList 
Table 6 - 18. ModuleProperties:SupModList 


Description Used by Libraries to restrict the set of modules that the code in this library supports. 
Required NO 


Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, UEFI_DRIVER, UEFI_RUNTIME _ 
DRIVER, UEFI_APPLICATION, USER DEFINED, SMM CORE. 
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Examples 


SupModList=” BASE” 


SupModList=”"”PEIM DXE_DRIVER” 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER” 


6.3.3 ModuleProperties.ModuleType 


Table 6 - 19. ModuleProperties.ModuleType 


Description 
Required 


Data Type 


Data Constraints 


Examples 


Define the Module type that this module is. 
YES 
Element — ModuleType 


If specified, must contain one and only one of the supported module types. The 
supported module types include BASE, SEC, PEI_CORE, PEIM, DXE_CORE, 
DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL DRIVER, DXE _ 
SMM DRIVER, UEFI_DRIVER, UEFI_RUNTIME DRIVER, UEFI_ 
APPLICATION, USER_DEFINED ,SMM_ CORE.. 


<ModuleType> BASE </MODULE_TYPE> 
<ModuleType> PEIM < /MODULE_TYPE> 
SupModList=“UEFI_DRIVER” 


6.3.4 ModuleProperties.Path 


Table 6 - 20. ModuleProperties.Path 


Description 


Required 


Data Type 


Data Constraints 


Examples 


For stand-alone modules that are NOT part of any package, this is the path to the 
root of the module as listed in the Distribution Content File. For modules included 
in a package, this is the location, relative to the root of the package this module 
belongs to. 


YES 
Element -— xs:anyURI 


A valid (Distribution Content File or Package) relative path to the root of the 
Module. 


<Path>Libraries/BaseLib</Path> 
<Path> EfiShellBin </Path> 
<Path>Universal/Disk/DiskIo/Dxe</Path> 


6.3.5 ModuleProperties.PcdlsDriver 


Table 6 - 21. ModuleProperties.PcdlsDriver 
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This element is only required for the PEIM that produces the PCD PPI or the DXE 


D ipti 
eeenipnon Driver that produces the PCD Protocol. 


Required NO 


Data Type Element — xs:NCName 
Data Constraints One of enumerated type: PEI_PCD_DRIVERorDXE_PCD DRIVER 


<PcdIsDriver>PE I_PCD_DRIVER</PcdI sDriver> 


Exampl 
ai sic <PcdIsDriver>DXE_PCD DRIVER</PcdIsDriver> 


6.3.6 ModuleProperties.UefiSpecificationVersion 
Table 6 - 22. ModuleProperties.UefiSpecificationVersion 


The number should reflect the version of the UEFI specification that the module 
conforms to. This value should be provided. 


Description 
Required NO 
Data Type Element — xs:decimal 


Data Constraints A decimal value that must include the period character. 


<UefiSpecificationVersion> 2.1 


Examples 
P </UefiSpecificationVersion> 


6.3.7 ModuleProperties.PiSpecificationVersion 
Table 6 - 23. ModuleProperties.PiSpecificationVersion 


The number should reflect the version of the PI specification that the module 
conforms to. This may be left blank. 


Description 
Required NO 
Data Type Element — xs:decimal 


Data Constraints A decimal value that must include the period character. 


<PiSpecificationVersion> 1.0 


Examples 
P </PiSpecificationVersion> 


6.3.8 ModuleProperties.Specification 
Table 6 - 24. ModuleProperties.Specification 


One or more of these elements indicate that the module has been coded to 
conform to the specified Industry Standard Specifications. 


Description 
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Required NO 


Data Type Element — xs:NCName 
Data Constraints NA 


<Specification Version="1.0”> NoSuch_ MACHINE DOT _ 


E I 
oes COM </Specification> 


6.3.9 ModuleProperties.Specification:Version 
Table 6 - 25. ModuleProperties.Specification:Version 


The Industry Standard spec version of this Module. If a module is coded to support 
Description more than one version of a spec, such as support for USB 1.1 and USB 2.0 
specifications, then two different Specification lines should be used. 


Required YES 
Data Type Attribute — xs:decimal 
Data Constraints A decimal value that must include the period character. 


Version="1.0” 
Examples Version="1.1” 
Version="2.0” 


6.3.10 ModuleProperties.BootMode 
<BootMode> 
Usage=" one of the enumerated values " {1} 
SupArchList=" ArchListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
<SupportedBootModes> list of Boot Modes </SupportedBootModes> {1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</BootMode> {1,} 


Table 6 - 26. ModuleProperties. BootMode 


Description This is a list of boot modes supported or set by this module. 
Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.3.11 ModuleProperties.BootMode:Usage 
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Table 6 - 27. ModuleProperties.BootMode:Usage 


Description This element specifies the GUID Usage. 
Required YES 


Data Type Attribute - UsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 
CONSUMES or SOMETIMES PRODUCES 


CONSUMES means that the module supports the boot mode or that it may support 
Data Constraints the boot mode on some execution paths. 

PRODUCES means that the module will change the boot mode 

UNDEFINED - Implies that a Boot Mode is used, but the package creator does 

not know how it used. 


Usage=” PRODUCES” 


Examples Usage="CONSUMES” 


6.3.12 ModuleProperties.BootMode:SupArchList 
Table 6 - 28. ModuleProperties.BootMode:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this Boot 
Mode. If this attribute is not specified, then this Boot Mode may be used with any 

Description CPU Architecture. If this attribute is specified, then only those modules that support 
a subset of the CPU architectures specified by this element may use this 
BootMode. 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=“IA32” 
Examples SupArchList=“IA32 X64” 
SupArchList=“EBC IPF X64” 


6.3.13 ModuleProperties.BootMode:FeatureFlag 


Table 6 - 29. ModuleProperties.BootMode:FeatureFlag 


Used to restrict the use of this Boot Mode. An in-fix logical expression, evaluated 
left to right, for a range of values, using Relational, Equality and Logical Operators 
(NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that must evaluate to either True or 
False. The form PcdTokenSpaceGuidCName.PcdCName is required. 
Parentheses are recommended for clarity. If this attribute is specified, then this 
Boot Mode may only be used if the Boolean expression evaluates to true. 


Description 
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Required 


Data Type 


Data Constraints 


Examples 


NO 
Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE , GT 
and GE. 


FeatureFlag=”"true” 


6.3.14 ModuleProperties.BootMode.SupportedBootModes 


Table 6 - 30. ModuleProperties.BootMode.SupportedBootMode 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Firmware execution paths are divided into two main categories, a normal boot and 
a recovery boot (in the case of potential corruption.) Within these two paths, 
different paths can be taken based on a given state of the firmware, or through 
feature settings. ABootMode GUID can be installed (PRODUCES) or located 
(CONSUMES) based on these states and feature settings. The majority of these 
types map to the PI specification Boot Mode Services. The boot modes listed with 
Recovery are to indicate that the GUID is only valid during a recovery boot. 


YES 
Element — BootModeList 


One or more (space separated) of the enumerated data types: FULL, 
MINIMAL,NO_ CHANGE, DIAGNOSTICS, DEFAULT, S2_ RESUME, S3__ 
RESUME,S4 RESUME,S5 RESUME, FLASH UPDATE, RECOVERY _ 
FULL, RECOVERY_MINIMAL, RECOVERY _NO CHANGE, RECOVERY _ 
DIAGNOSTICS, RECOVERY_DEFAULT, RECOVERY_S2_ RESUME, 
RECOVERY _S3 RESUME, RECOVERY _S4 RESUME, RECOVERY _S5_ 
RESUME, RECOVERY FLASH UPDATE 

UNDEFINED - implies that the package creator does not know which of the boot 
modes are used. 


<SupportedBootModes> FULL RECOVERY FULL 
</SupportedBootModes> 


6.3.15 ModuleProperties.BootMode.HelpText 


Table 6 - 31. ModuleProperties.BootMode.HelpText 


Description 


Required 


Data Type 


Data Constraints 


This element specifies the HelpText describing how the module either sets or 
supports specific boot modes. 


NO 
Element — xs:string 


A string that contains one or more lines of text. 
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<HelpText> Initializes the Dxe Ipl PPI for all 


Examples 
7 boot modes except S3 Resume.</HelpText> 


6.3.16 ModuleProperties.BootMode.HelpText:Lang 
Table 6 - 32. ModuleProperties.BootMode.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
aig Cenetenis not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.3.17 ModuleProperties.Event 
<Event 
Usage="_UsageType " {1} 
EventType=" EventType " {1} 
SupArchList=" ArchListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
<HelpText 
Lang=""_xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</Event> 


Table 6 - 33. ModuleSurfaceArea. ModuleProperties.Event 


Description This is a list of non-GUIDed Events produced or consumed by this module. 
Required NO 
Data Type Element — Complex, nillable="true” 


Data Constraints N/A 


Examples N/A 


6.3.18 ModuleProperties.Event:Usage 
Table 6 - 34. ModuleProperties.Event:Usage 


Description This element specifies the non-GUIDed Event Usage. 


Required YES 
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Data Type 


Data Constraints 


Examples 


Attribute — UsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 
CONSUMES or SOMETIMES PRODUCES 

PRODUCES means that a module will produce a GUID that does not fit into the 
defined PROTOCOL, PPI or other GUID types. 

CONSUMES means that a module may use this GUID that does not fit into the 
defined GUID types. 

UNDEFINED - implies that an Event is used, but the package creator does not 
know how it used. 


Usage=” PRODUCES” 
Usage=”"CONSUMES” 


6.3.19 ModuleProperties.Event:EventType 


Table 6 - 35. ModuleProperties.Event:EventType 


Description 


Required 


Data Type 


Data Constraints 


Examples 


This element specifies the type of Event. 
YES 
Attribute — UsageType 


One of the enumerated values: EVENT TYPE PERIODIC _TIMERor 
EVENT TYPE RELATIVE TIMER 

UNDEFINED - implies that an event is used, but the package creator does not 
know the Event Type. 


EventType="EVENT TYPE RELATIVE TIMER” 


6.3.20 ModuleProperties.Event:SupArchList 


Table 6 - 36. ModuleProperties.Event:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this GUID. If 
this attribute is not specified, then this GUID may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that support a 
subset of the CPU architectures specified by this element may use this GUID. 


NO 
Attribute — ArchListType 


If specified, must contain one or more of the supported CPU architectures 
separated by spaces. The supported CPU architectures include IA32, X64, IPF 


, ARM and EBC 


SupArchList=“IA32” 


SupArchList=“IA32 X64” 


SupArchList=“EBC IPF X64” 
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6.3.21 ModuleProperties.Event:FeatureFlag 
Table 6 - 37. ModuleProperties.Event:FeatureFlag 


Used to restrict the use of this GUID. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. It may be an in-fix logical 
expression, evaluated left to right, for a range of values, using Relational, Equality 
and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that must 
evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
GUID may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=” true” 


6.3.22 ModuleProperties.Event.HelpText 
Table 6 - 38. ModuleProperties.Event.HelpText 


This element specifies the HelpText describing how the module sets or waits for a 


Description timer event. 


Required NO 
Data Type Element -— xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText> If Password is NULL unlock the 
password state variable and set the event timer. 
If the Password is too big return an error. If 
the Password is valid, copy the Password and 
enable state variable and then arm the periodic 
timer. </HelpText> 


Examples 


6.3.23 ModuleProperties.Event.HelpText:Lang 
Table 6 - 39. ModuleProperties.Event.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 


Required NO 


Data Type Attribute — xs:language 
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If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.3.24 ModuleProperties.HOB 
<HOB 
Usage="UsageType " {1} 
HobType="HobType " {1} 
SupArchList=" ArchListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
<HelpText 
Lang=""_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</HOB> 


Table 6 - 40. ModuleSurfaceArea. ModuleProperties. HOB 


Description This is a list of non-GUIDed HOBs produced or consumed by this module. 


Required NO 
Data Type Element — Complex, nillable="true” 
Data Constraints N/A 


Examples N/A 


6.3.25 ModuleProperties.HOB:Usage 
Table 6 - 41. ModuleProperties. HOB:Usage 


Description This element specifies the HOB Usage. 
Required YES 
Data Type Attribute — UsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 
CONSUMES or SOMETIMES PRODUCES 

PRODUCES means that a module will produce a HOB that does not fit into the 
defined PROTOCOL, PPI or other GUID types. 

CONSUMES means that a module may use this HOB that does not fit into the 
defined GUID types. 

UNDEFINED - implies that a HOB is used, but the package creator does not 
know how it used. 

UNDEFINED - implies that a HOB is used, but the package creator does not 
know how itis used. 


Data Constraints 


Usage=” PRODUCES” 
Usage=”"CONSUMES” 


Examples 
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6.3.26 ModuleProperties.HOB:HobType 
Table 6 - 42. ModuleProperties. HOB :HobType 


Description This element specifies the type of HOB. 
Required YES 


Data Type Attribute — Enumerated list value 


One of the enumerated values: PHIT, MEMORY ALLOCATION, 


RESOURCE DESCRIPTOR, FIRMWARE VOLUME or LOAD PEIM 
UNDEFINED - implies that a HOB is used, but the package creator does not 
know the type of HOB. 


Data Constraints 


HobType=” PHIT” 


Example HobType="LOAD_PEIM” 


6.3.27 ModuleProperties.HOB:SupArchList 
Table 6 - 43. ModuleProperties.HOB:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this HOB. If this 
attribute is not specified, then this HOB may be used with any CPU Architecture. If 
this attribute is specified, then only those modules that support a subset of the CPU 
architectures specified by this element may use this GUID. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList=“IA32” 


Examples SupArchList="IA32 x64” 


6.3.28 ModuleProperties.HOB:FeatureFlag 
Table 6 - 44. ModuleProperties.HOB:FeatureFlag 


Used to restrict the use of this HOB. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
HOB may only be used if the Boolean expression evaluates to true. 


Description 
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Required NO 


Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Dat traint 
ata Constraints and GE. 


Examples FeatureFlag=” true” 


6.3.29 ModuleProperties.HOB.HelpText 
Table 6 - 45. ModuleProperties. HOB.HelpText 


Description This element specifies the HelpText describing correct usage of the HOB. 
Required NO 

Data Type Element — xs:string 

Data Constraints A string that contains one or more lines of text. 


<HelpText> This Module uses the 
gEfiHobMemoryAllocStackGuid to build a new memory 

Examples allocation HOB with old stack info with 
EfiConventionalMemory type to be reclaimed by DXE 
core. </HelpText> 


6.3.30 ModuleProperties.HOB.HelpText:Lang 
Table 6 - 46. ModuleProperties.HOB.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraint 
Consens not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.4 ModuleSurfaceArea.ClonedFrom 


The following is the description of the ModuleSurfaceArea .ClonedFronm instance: 
<ClonedFrom> 
<GUID 
Version="_ xs:decimal " {1} > 
RegistryFormatGuid 
</GUID> {1} 
</ClonedFrom> 
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6.4.1 ModuleSurfaceArea.ClonedFrom 
Table 6 - 47. ModuleSurfaceArea. ClonedFrom 


If the module sources were copied from an existing Module, then this Section can 


Recast 
eSchipion be used to track the lineage. 


Required NO 


Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.4.2 ClonedFrom.GUID 
Table 6 - 48. ClonedFrom.GUID 


If the module sources were copied from an existing Module, this is the GUID of the 
Module. 


Description 
Required YES 

Data Type Element — RegistryFormatGuid 

Data Constraints Registry format GUID of the Module this module was copied from. 


<GUID Version="2”>27d67720-ea68-48ae-93da- 


Examples a3a074c90e30</GUID> 


6.4.3 ClonedFrom.GuidValue:Version 
Table 6 - 49. ClonedFrom.GuidValue:Version 


Description This is the version of the Module that this module was copied from. 
Required YES 
Data Type Attribute — xs:decimal 


Data Constraints Version number of the existing Module 


Examples Version="1.0” 


6.5 ModuleSurfaceArea.LibraryClassDefinitions 


The following is the description of the 
ModuleSurfaceArea.LibraryClassDefinitions instance: 
<LibraryClassDefinitions> 
<LibraryClass 
Usage="" LibUsageType " {1} 
SupArchList=" ArchListType " {0,1} 
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SupModList=" ModuleListType " {0,1} 

FeatureFlag="_ xs:normalizedString " {0,1} > 
<Keyword> xs:NCName </Keyword> {1} 
<RecommendediInstance> 


<GUID 
Version="_ xs:decimal " {0,1} > 
RegistryFormatGuid 


</GUID> {1} 
</RecommendediInstance> {0,1} 
<HelpText 

Lang=""_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</LibraryClass> {1,} 
</LibraryClassDefinitions> 


Table 6 - 50. ModuleSurfaceArea.LibraryClassDefinitions 


A list the different Library Classes consumed by a driver, core and application 
module, or produced by a Library module. 


Description 


Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.5.1 LibraryClassDefinitions.LibraryClass 
Table 6 - 51. LibraryClassDefinitions.LibraryClass 
Description A Library Class 
Required YES 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.5.2 LibraryClassDefinitions.LibraryClass:Usage 
Table 6 - 52. LibraryClassDefinitions. LibraryClass:Usage 


The Usage attribute which defines whether a Library Instance might be needed by 


D ipti 
Se a the module, or if this a Library Instance for the specified LibraryClass. 


Required YES 
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Data Type Attribute — xs:NCName 


One of the enumerated values: PRODUCES, CONSUMES or SOMETIMES _ 


CONSUMES . 
UNDEFINED - implies that a library class is used, but the package creator does 
not know how it used. 


Data Constraints 


Examples Usage=” PRODUCES” 


Parameters 

CONSUMES 
The module requires one and only one library instance for the Library Class 
specified in the Keyword sub-element. 

PRODUCES 
This module is a library instance of the Library Class specified in the Keyword sub- 
element. 

SOMETIMES CONSUMES 


The module may need one and only one library instance for the Library Class 
specified in the Keyword sub-element under some conditions. 


6.5.3 LibraryClassDefinitions.LibraryClass:SupArchList 
Table 6 - 53. LibraryClassDefinitions.LibraryClass:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this Library 
Class. If this attribute is not specified, then this Library Class may be used with any 

Description CPU Architecture. If this attribute is specified, then only those modules that support 
a subset of the CPU architectures specified by this element may use this Library 
Class. 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=”"IA32” 
Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.5.4 LibraryClassDefinitions.LibraryClass:SupModList 
Table 6 - 54. LibraryClassDefinitions.LibraryClass:SupModList 
Used to restrict the set of module types that are allowed to use this Library Class. If 


Description this attribute is not specified, then this Library Class may be used with all module 
types. If this attribute is specified, then only those modules that have a module type 
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Required 


Data Type 


Data Constraints 


Examples 


that is a member of the set of module types specified by this element may use this 
Library Class. 


NO 


Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 


spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, UEFI_DRIVER, UEFI_RUNTIME _ 
DRIVER, UEFI_APPLICATION, USER_DEFINED, SMM CORE. 


SupModList=” BASE” 

SupModList=”PEIM DXE_DRIVER” 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER” 


6.5.5 LibraryClassDefinitions.LibraryClass:FeatureFlag 


Table 6 - 55. LibraryClassDefinitions.LibraryClass:FeatureFlag 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used to restrict the use of this Library Class. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False.The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
Library Class may only be used if the Boolean expression evaluates to true. 


NO 
Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 
and GE. 


FeatureFlag=”true” 


Table 6 - 56. LibraryClassDefinitions._LibraryClass.Keyword 


Description 


Required 


Data Type 


Data Constraints 


Used by the UI tools to identify different instances of libraries that provide the 
library class. 


YES 


Element — xs:‘NCName 


A single word that starts with an alpha character followed by one or more 
alphanumeric characters. The underscore “_” character is the only non- 
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alphanumeric character allowed. 


<Keyword>BaseMemoryLib</Keyword> 


Epamibles <Keyword>CacheMaintenanceLib</Keyword> 


6.5.6 LibraryClassDefinitions.LibraryClass.Recommendedinstance 
Table 6 - 57. LibraryClassDefinitions. LibraryClass.Recommendedinstance 


The recommended library instance as defined by the creator of the Library Class 
Header file. 


Description 
Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.5.7 LibraryClassDefinitions.LibraryClass.Recommendedinstance.GUID 
Table 6 - 58. LibraryClassDefinitions. LibraryClass.Recommendedinstance.GUID 


The GUID of the recommended library instance as defined by the creator of the 
Library Class Header file. This is a required element. If GUID is specified, and the 
Version attribute is not, then the algorithm to look up the recommended instance is 
to find the library instance highest version number and a matching GUID. 


Description 


Required YES 
Data Type Element — RegistryFormatGuid 


A string that represents a GUID in registry format. Not valid if no Recommendedinf 


Data Constraints 
attribute specified. 


Examples <GUID>AFODDA2E-EA83-480b-B2CE-FCOBB2F894C2</GUID> 


6.5.8 
LibraryClassDefinitions.LibraryClass.Recommendedinstance.GU 
ID:Version 


Table 6 - 59. LibraryClassDefinitions.LibraryClass:RecommendedInstance.GUID:Version 


The version of the recommended library instance as defined by the creator of the 
Description Library Class Header file. If this attribute is not specified, then the recommended 


library instance is the highest version number with a matching GUID. 


Required NO 


- 209 - 


Chapter 6 


Data Type Attribute — xs:decimal 


Data Constraints Unsigned decimal number. 


Version="1.0” 


E | 
a aa Version="2.75” 


6.5.9 LibraryClassDefinitions.LibraryClass.HelpText 
Table 6 - 60. LibraryClassDefinitions.LibraryClass.HelpText 


Used by the UI tools to provide information about this library class, it’s uses and 
functionality. 


Description 
Required NO 
Data Type Element — xs:string 


Data Constraints A string that contains one or more lines of text. 


<HelpText> Base Memory Library that uses MMX 
Examples registers for high performance. Optimized for use 
in DXE. </HelpText> 


6.5.10 LibraryClassDefinitions.LibraryClass.HelpText:Lang 
Table 6 - 61. LibraryClassDefinitions._LibraryClass.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.6 ModuleSurfaceArea.SourceFiles 


This section is required if and only if this Module is NOT a Binary Module. If this is a binary 
module, then this section is not permitted. 


The following is the description of the ModuleSurfaceArea.SourceFiles instance: 


<SourceFiles> 
<Filename 
Family=" FamilyType " {0,1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
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xs:anyURI 
</Filename> {1,} 
<HelpText 
Lang=""_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</SourceFiles> 


Table 6 - 62. ModuleSurfaceArea.SourceFiles 


This element contains a list of all text-based code (including Unicode text) files that 
are included with this module. 


Description 


Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.6.1 SourceFiles.Filename 
Table 6 - 63. SourceFiles.Filename 


Description Source files used by tools to create binary files. 
Required YES 
Data Type Element — xs:anyURI 


The path (relative to the Module “root” directory) and filename of the file (as 


Data Constraints 
specified in the Distribution Content File.) 


<Filename>SwitchStack.c</Filename> 
<Filename 

Examples SupArchList="1IA32”>x86LowLevel .c</Filename> 
<Filename SupArchList="1IA32”>Ia32/Non- 
existing.c</Filename> 


6.6.2 SourceFiles.Filename:Family 
Table 6 - 64. SourceFiles.Filename:Family 


The Family attribute is used to restrict usage to a given family of compilers, such as 
GCC or MSFT. Since not all code processing tools use the same syntax, especially 
for assembly, this field can be used to identify different syntax. If not specified, then 
any family can use this file. 


Description 


Required NO 
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Data Type 


Data Constraints 


Examples 


Attribute — FamilyType 
[A-Z] [a-zA-Z0-9]* 


Family="GCC” 
Family="MSFT” 


6.6.3 SourceFiles.Filename:SupArchList 


Table 6 - 65. SourceFiles.Filename:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this filename. If 
this attribute is not specified, then this filename may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use this filename. 


NO 
Attribute — ArchListType 
[A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList="IA32” 
SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.6.4 SourceFiles.FileName:SupModList 


Table 6 - 66. SourceFiles.Filename:SupModList 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used by libraries to restrict the set of module types that are allowed to use this file. 
If this attribute is not specified, then this file may be used by any module type. If this 
attribute is specified, then only those modules are in a subset of the module types 
specified by this element may use this file. 


NO 
Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 


spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE _ 
DRIVER" 
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6.6.5 SourceFiles.Filename:FeatureFlag 
Table 6 - 67. SourceFiles.Filename:FeatureFlag 


Used to restrict the use of this filename. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is an in-fix logical 
expression, evaluated left to right, for a range of values, using Relational, Equality 
and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that must 
evaluate to either True or False. The form 

PcdTokenSpaceGuidC Name.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
filename may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=”true” 


6.6.6 SourceFiles.HelpText 
Table 6 - 68. SourceFiles.HelpText 


Description Used by the UI tools to provide information about source files in this module. 
Required NO 

Data Type Element -— xs:string 

Data Constraints A string that contains one or more lines of text. 


<HelpText> Sample driver using HII protocol. 


E | 
eee </HelpText> 


6.6.7 SourceFiles.HelpText:Lang 
Table 6 - 69. SourceFiles.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier. 
Required NO 
Data Type Attribute — xs:Language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is "en-us.' 


Examples Lang="en-us" 


- 213 - 


Chapter 6 


6.7 ModuleSurfaceArea.BinaryFiles 


If no Source Files are specified, then the files listed here will not be processed during a build. 
They are either PI FFS sections, UEFI images or Binary files. 


The following is the description of the ModuleSurfaceArea.BinaryFiles instance: 
<BinaryFiles> 
<BinaryFile> 
<Filename 
FileType=" FileType " {1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" FeatureFlagExpression " {0,1} > 
GUID="" RegistryFormatGuid " {0,1} > 
xs:anyURI 
</Filename> {1,} 
<AsBuilt> ... </AsBuilt> {0,} 
<HelpText 
Lang=""_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</BinaryFile> {1,} 
</BinaryFiles> 


Table 6 - 70. ModuleSurfaceArea.BinaryFiles 


This element contains a list of all binary files that are included with a module. If 
Description Source files have been specified, these files may be included in a module. 
Typically, this section is used for distribution of binary only code. 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.1 BinaryFiles.BinaryFile 
Table 6 - 71. BinaryFiles.BinaryFile 


Description User can enter any data that might help other developers using this source code. 
Required YES 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 
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6.7.2 BinaryFiles.BinaryFile.Filename 


Table 6 - 72. BinaryFiles.BinaryFile.Filename 


Description Module Relative path and filename for a binary file. 


Required YES 
Data Type Element — xs:anyURI 


The path (relative to the Module’s “root” directory and filename of the file (as 


Data Constraints 
specified in the Distribution Content File.) 


<Filename 

FileType=” PE32”>SwitchStack .efi</Filename> 
<Filename SupArchList="IA32” FileType=”"BIN” > 
IA32/LowLevel.bin </Filename> 

<Filename FileType="BIN” SupArchList="X64"> 
X64/LowLevel.bin </Filename> 


Examples 


6.7.3 BinaryFiles.BinaryFile.Filename:FileType 
Table 6 - 73. BinaryFiles.BinaryFile.Filename:FileType 


Description Specify the type of binary file provided. 
Required YES 
Data Type Attribute — BinFileType 


One of the enumerated values: GUID, FREEFORM, UEFI_ IMAGE, PE32, 
Data Constraints PIC, PEI_DEPEX, DXE_DEPEX, TE, VER, UI, BIN, FV, SMM DEPEX ; 
COMPAT16, DISPOSABLE 


FileType=” PE32” 


i FileType="UI” 


6.7.4 BinaryFiles.BinaryFile.Filename:SupArchList 
Table 6 - 74. BinaryFiles.BinaryFile.Filename:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this filename. If 
this attribute is not specified, then this filename may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use this filename. 


Description 


Required NO 


Data Type Attribute — ArchListType 


Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 
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Examples 


SupArchList=”"IA32” 


SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.7.5 BinaryFiles.FileName:SupModList 


Table 6 - 75. BinaryFiles.BinaryFile.Filename:SupModList 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used by libraries to restrict the set of module types that are allowed to use this file. 
If this attribute is not specified, then this file may be used by any module type. If this 
attribute is specified, then only those modules are in a subset of the module types 
specified by this element may use this file. 


NO 
Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER" 


6.7.6 BinaryFiles.BinaryFile.Filename:FeatureFlag 


Table 6 - 76. BinaryFiles.BinaryFile.Filename:FeatureFlag 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used to restrict the use of this filename. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
filename may only be used if the Boolean expression evaluates to true. 


NO 
Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 
and GE. 


FeatureFlag=”PcdSupportUpdateCapsuleRest” 
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6.7.7 BinaryFiles.BinaryFile.Filename:Guid 


Table 6 - 77. BinaryFiles.BinaryFile.Filename:GUID 


An optional GUID attribute to the BinaryFiles.BinaryFile.Filename element which is 
Description only valid ifthe FileType is set to "FREEFORM", FREEFORNM is shorthand 
notation forEFI_ SECTION FREEFORM SUBTYPE GUID. 


Required NO 
Data Type Attribute — RegistryFormatGuid 


This attribute is only legal if the filename's FileType attribute is set to 


Data Constraints “FREEFORM" 


Examples GUID="964052d9-3724-4777-b220-0b42ccf7b6de" 


6.7.8 BinaryFiles.BinaryFile.AsBuilt 


If this is a binary module distribution, this section contains information about how the module was 
coded, such as Compiler Tools, Flags, PCDs (only PatchPcd, Ped and/or PedEx) and Library Class 
Instances used to build the binary. 


<AsBuilt> 

<PatchPcdValue> ... </PatchPcdValue> {0,} 

<PcdExValue> ... </PcdExValue> {0,} 

<LibraryInstances> ... </LibraryInstances> {0,1} 

<BuildFlags> Any attributes or content is permitted <BuildFlags> 
{0,} 


</AsBuilt> {0,} 
Table 6 - 78. BinaryFiles.BinaryFile.AsBuilt 


This section covers the information required by developers receiving a binary 
distribution. 'If this is a binary module distribution, this section contains information 
about how the module was coded, such as Compiler Tools, Flags, PCDs (only 
PatchPcd, Pcd and/or PcdEx) and Library Class Instances used to build the binary. 


Description 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.9 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue 
<PatchPcdValue 
PcdUsage="_ xs:NCName " {1}> 
<TokenSpaceGuidValue> RegistryFormatGuid </TokenSpaceGuidValue> {1} 
<PcdCName> xs:NCName </PcdCName> {1} 
<Token> HexNumber </Token> {1} 
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<DatumType> PcdDatumType </DatumType> {1} 

<MaxDatumSize> HexNumber </MaxDatumSize> {0,1} 

<Value> xs:normalizedString </Value> {1} 

<Offset> HexNumber </Offset> {1} 

<HelpText> ... </HelpText> {0,} 

<PedError> ... </PcedError> {0,} 

<PcdConsumesRules> PcdConsumesExpression </PcdConsumesRules> {0,} 
</PatchPcdValue> 


Table 6 - 79. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue 


An optional section that can describes any patchable PCDs that may be pertinent 


Description 
ne to this binary module. 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.10 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue:PcdUsage 
Table 6 - 80. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue:PcdUsage 


Description This attribute specifies whether the Pcd is required or produced by the module. 
Required YES 
Data Type Attribute — xs:NCName 


One of the enumerated values: CONSUMES, SOMETIMES CONSUMES, 
PRODUCES or SOMETIMES PRODUCESor UNDEFINED. 
UNDEFINED - implies that a PCD is used, but the package creator does not 
know how it used or the usage does not fit one of the other uses. . 


Data Constraints 


PcdUsage=” PRODUCES” 
PcdUsage=” CONSUMES” 


Examples 


Parameters 
CONSUMES 


This module always gets the PCD entry. 
PRODUCES 


The module always sets the PCD entry. 
SOMETIMES CONSUMES 


The module gets the PCD entry under certain conditions or execution paths. 
SOMETIMES PRODUCES 


The module gets the PCD entry under certain conditions or execution paths. 
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6.7.11 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. 


Table 6 - 81. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. TokenSpaceGuidValue 


Description The GUID value TokenSpaceGuid that defines this PCD. 


Required YES 
Data Type Element — RegistryFormatGuid 
Data Constraints Registry format GUID of the Token Space GUID. 


<TokenSpaceGuidValue> 914AEBE7-4635-459b-AA1C- 


Exaunice 11E219B03A10 </TokenSpaceGuidValue> 


6.7.12 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. Token 
Table 6 - 82. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. Token 


Description The Token Number of this PCD. 
Required YES 
Data Type Element — HexNumber 


The hex token number used during the platform build. This element must contain 


Data Constraints F ; 
one to eight hexadecimal characters. 


Examples <Token>0x00000006</Token> 


6.7.13 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdCName 
Table 6 - 83. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdCName 


Description The name of this PCD. 
Required YES 
Data Type Element — xs:NCName 


A string that starts with a letter followed by any combination of letters, digits, 


Data Constraints 
underscores, and periods. No whitespace characters are allowed. 


Examples <PcdCName> PcdDebugPrintErrorLevel </PcdCName> 


6.7.14 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.DatumType 


Table 6 - 84. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.DatumType 


Description The data type of this PCD. 
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Required YES 


Data Type Element — xs:NCName 


One of the following enumerated data types: UINT8, UINT16, UINT32, UINT64, 


Data Constraints BOOLEAN, or VOID* 


Examples <DatumType> VOID* </DatumType> 


6.7.15 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.MaxDatum Size 
Table 6 - 85. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.MaxDatumSize 


The maximum data size allocated for this PCD; this is required for VOID* Pcd 
Datum Types. 


Description 
Required NO (Depending on the PCD’s datum type) 
Data Type Element — HexNumber 


Data Constraints A hex value. 


Examples <MaxDatumSize> 0x0000001F </MaxDatumSize> 


6.7.16 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.Value 
Table 6 - 86. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. Value 


Description The value that was used at build time in the binary. 
Required YES 
Data Type Element -— xs:normalizedString 


A string that starts with a letter followed by any combination of letters, digits, 


Data Constraints 
underscores, and periods. Whitespace characters are allowed. 


Examples <Value>"en-US ; fr-FR"<Value> 


6.7.17 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.Offset 
Table 6 - 87. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue. Offset 


Description The offset into the binary of this PCD. 
Required YES 
Data Type Element — HexNumber 


Data Constraints The hex address into the binary image of the PCD 


Examples <Offset> 0x00000200 </Offset> 
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6.7.18 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.HelpText 
Table 6 - 88. BinaryFiles.BinaryFile. AsBuilt.PatchPcdValue.HelpText 


Description A complete description of a how the PCD is implemented. 
Required NO 
Data Type Element -— xs:string 


Data Constraints | Astring that contains one or more lines of text. 


<HelpText> 
The PcdDebugPropertyMask is an 8-bit mask of 


debug properties that may be set to a unique 
value for each module in the platform. This PCD 
Entry is available to all CPU and Module types 
and was configured as BINARY PATCHABLE and the 
following bit settings: 

#define DEBUG PROPERTY DEBUG ASSERT ENABLED 0x01 

#define DEBUG PROPERTY DEBUG PRINT ENABLED 0x02 
</HelpText> 


Examples 


6.7.19 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.HelpText:Lang 
Table 6 - 89. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
Ble Constants not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
a ss Lang="fra” 


6.7.20 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValu 


eList 
Table 6 - 90. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValueList 


Description A list of valid values 


Required NO 


Data Type Element -— xs:normalizedString 
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Space Separated list of values. Restricted to the data type of this PCD. Use of the 
L’string” is permitted to specify a UTF-8 text string that will be converted to 
UNICODE (UCS2) formatin the code. Words that are not quoted are considered to 
be enumerations. 


Data Constraints 


<ValidValueList> 0xb0000000 0xb0000001 
</ValidValueList> 

<ValidValueList> “Blue” “Red” “White” 
</ValidValueList> 

<ValidValueList> orange peach apple pear 
</ValidValueList> 


Examples 


6.7.21 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValu 


eList:Lang 
Table 6 - 91. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValueList:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
aia Constainis not specified, the default is “en-us”. 


Lang="en-us” 


E | 
oes Lang="fra” 


6.7.22 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValu 
eRange 


Table 6 - 92. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ValidValueRange 


Description The valid range of values using C style nomenclature. 
Required NO 
Data Type Element — xs:normalizedString 


This is required to be an in-fix logical expression, evaluated left to right, for a range 
of values, using Relational, Equality and Logical Operators (NOT, OR, AND, LT, 
LE, EQ, GT, GE and XOR) that must evaluate to either True or False. The forms 


Data Constraints PcdCName and/or PcdTokenSpaceGuidCName.PcdCName are permitted; if only 
the PcdCName is specified, then the PcdTokenSpaceGuidCName is the same as 
this PCD's TokenSpaceGuidCName. Parentheses are recommended for clarity. All 
other values must be numeric. 
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<ValidValueRange> (0xb0000000 LE PcdCNameGoesHere 
) AND (PcdCNameGoesHere GT 0x00010000) 


</ValidValueRange> 

<ValidValueRange> PcdCNameGoesHere LT 0x10001FFF 
AND (PcdCNameGoesHere NOT EQ 0x8000000) 
</ValidValueRange> 


Examples 


6.7.23 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.Expressi 
on 


Table 6 - 93. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.Expression 


An in-fix logical expression, evaluated left to right, using Relational, Equality and 
Logical Operators (NOT, AND, OR, GT, GE, EQ, LE, LT and XOR) and parenthesis 
are recommended. The forms PcdCName and/or 
PcdTokenSpaceGuidCName.PcdCName are permitted; if only the PcdCName is 
specified, then the PcdTokenSpaceGuidCName is the same as this PCD's 
TokenSpaceGuidCName. 


Description 


Required NO 
Data Type Element -— xs:normalizedString 


Data Constraints 


<Expression> (NOT gPcdRecoveryMode) AND 
gPcdS3Resume </Expression> 


Examples 


6.7.24 BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError 
<PcdError> 
<choice> 
<ValidValueList 
Lang="_ xs:language " {0,1} > 
xs :normalizedString 
</ValidValueList> 
<ValidValueRange> xs:normalizedString </ValidValueRange> 
<Expression> xs:normalizedString </Expression> 
</choice> 
<ErrorNumber> HexNumber </ErrorNumber> {1} 
<ErrorMessage 
Lang=""_ xs:language " {0,1} > 
xs:string 
</ErrorMessage> {0,} 
</PcdError> 


Table 6 - 94. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError 
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Valid Error messages implemented in this module for the PatchPcd entry. Only 
Description One Error Number per PcdError, (multiple ErrorMessage entries are permitted) and 
multiple PcdError elements are permitted. 


Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.25 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorNu 
mber 


Table 6 - 95. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorNumber 


Description Valid error number per specifications. 

Required YES 

Data Type Element — HexNumber 

Data Constraints A hexadecimal value for the error message as defined by specifications. 


<ErrorNumber>0xb0000000</ErrorNumber> 


Eanes <ErrorNumber>0xb0000001</ErrorNumber> 


6.7.26 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorMes 
sage 


Table 6 - 96. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorMessage 
Description An error message for conditional failures of the choices above. 
Required NO 


Data Type Element -— xs:string 


Data Constraints A string that contains one or more lines of text. 


<ErrorMessage> The value specified exceeds the 
maximum value allowed. </ErrorMessage> 


Examples 


6.7.27 
BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorMes 
sage:Lang 


Table 6 - 97. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdError.ErrorMessage:Lang 


2904. 


Description 
Required 


Data Type 


Data Constraints 


Examples 
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The language code uses an RFC 1766 language code identifier 


NO 
Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 
not specified, the default is “en-us.’ 


Lang="en-us” 
Lang="fra” 


BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdConsumesRul 


es 


Table 6 - 98. BinaryFiles.BinaryFile.AsBuilt.PatchPcdValue.PcdC onsumesRules 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used to clarify when this this PCD is used by the binary module. This elementis a 
Boolean expression containing PCDs names, operators, and PPIs, GUIDs, and 
Protocols marked as CONSUMES or SOMETIMES_CONSUMES. This is required 
to be an in-fix logical expression, evaluated left to right, for a range of values, using 
Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidCName.PcdCName must be used. Parentheses are 
recommended for clarity. If the PcdConsumesExpression does not evaluate to true, 
then the value of this PCD will be ignored by the binary module 


NO 
Attribute — xs:normalizedString 


PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 
OR, XOR, EQ, LT, LE, GT and GE. 


<PcdConsumesRules> gEfiDevicePathProtocolGuid AND 
(TokenSpaceGuid.PcdCName EQ 4) 
</PcdConsumesRules> 


6.7.29 BinaryFiles.BinaryFile.AsBuilt.PcdExValue 


<PcdExValue 
PcdUsage=" 


xs:NCName " {1}> 


<TokenSpaceGuidValue> RegistryFormatGuid </TokenSpaceGuidValue> {1} 


<PcdCName> 


xs:NCName </PcdCName> {1} 


<Token> HexNumber </Token> {1} 
<DatumType> PcdDatumType </DatumType> {1} 
<MaxDatumSize> HexNumber </MaxDatumSize> {0,1} 


<Value> xs: 
<HelpText> ... 


<PcdError> 


normalizedString </Value> {0,1} 
</HelpText> {0,} 
. </PedError> {0,} 


<PcdConsumesRules> PcdConsumesExpression </PcdConsumesRules> {0,} 
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</PcdExValue> 
Table 6 - 99. BinaryFiles.BinaryFile.AsBuilt.PcdExValue 


An optional section that can describes any dynamic PCDs that may be pertinent to 
this binary module. 


Description 


Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.30 BinaryFiles.BinaryFile.AsBuilt.PcdExValue:PcdUsage 
Table 6 - 100. BinaryFiles.BinaryFile.AsBuilt.PcdExValue:PcdUsage 


Description This attribute specifies whether the Pcd is required or produced by the module. 
Required YES 
Data Type Attribute — xs:NCName 


One of the enumerated values: CONSUMES, SOMETIMES CONSUMES, 


Data Constraints PRODUCES or SOMETIMES PRODUCESor CONSUMES. 


PcdUsage=” PRODUCES” 


Ene PcdUsage=” CONSUMES” 


Parameters 
CONSUMES 
This module always gets the PCD entry. 
PRODUCES 
The module always sets the PCD entry. 
SOMETIMES CONSUMES 
The module gets the PCD entry under certain conditions or execution paths. 
SOMETIMES _ PRODUCES 


The module sets the PCD entry under certain conditions or execution paths. 


6.7.31 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdCName 
Table 6 - 101. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdCName 


Description The name of this PCD. 


Required YES 
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Data Type Element — xs:NCName 


A string that starts with a letter followed by any combination of letters, digits, 


Data Constraints 
underscores, and periods. No whitespace characters are allowed. 


Examples <PcdCName> PcdDebugPrintErrorLevel </PcdCName> 


6.7.32 BinaryFiles.BinaryFile.AsBuilt.PcdExValue. TokenSpaceGuidValue 
Table 6 - 102. BinaryFiles.BinaryFile. AsBuilt.PcdExValue. TokenSpaceGuidValue 


Description The GUID value TokenSpaceGuid that defines this PCD. 
Required YES 

Data Type Element — RegistryFormatGuid 

Data Constraints Registry format GUID of the Token Space GUID. 


<TokenSpaceGuidValue> 914AEBE7-4635-459b-AA1C- 


Examples 11E219B03A10 </TokenSpaceGuidValue> 


6.7.33 BinaryFiles.BinaryFile.AsBuilt.PcdExValue. Token 
Table 6 - 103. BinaryFiles.BinaryFile.AsBuilt.PcdExValue. Token 


Description The Token Number of this PCD. 
Required YES 
Data Type Element — HexNumber 


The hex token number used during the platform build. This element must contain 


Data Constraints 
one to eight hexadecimal characters. 


Examples <Token>0x00000006</Token> 


6.7.34 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.DatumType 
Table 6 - 104. BinaryFiles.BinaryFile.AsBuilt.PcdExValue. DatumType 


Description The data type of this PCD. 
Required YES 
Data Type Element — xs:‘NCName 


One of the following enumerated data types: UINT8, UINT16, UINT32, UINT64, 


Data Constraints BOOLEAN, or VOID* 


Examples <DatumType> VOID* </DatumType> 
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6.7.35 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.MaxDatum Size 
Table 6 - 105. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.MaxDatumSize 


The maximum data size allocated for this PCD; this is required for VOID* Pcd 


D ipti 
peer Datum Types. 


Required NO (Depending on the PCD’s datum type) 


Data Type Element — HexNumber 
Data Constraints A hex value. 


Examples <MaxDatumSize> 0x0000001F </MaxDatumSize> 


6.7.36 BinaryFiles.BinaryFile.AsBuilt.PcdExValue. Value 
Table 6 - 106. BinaryFiles.BinaryFile.AsBuilt.PcdExValue. Value 


Description The value that was used at build time in the binary. 
Required NO 
Data Type Element — xs:normalizedString 


A string that starts with a letter followed by any combination of letters, digits, 


Data Constraints 
underscores, and periods. Whitespace characters are allowed. 


Examples <Value>en-US ; fr-FR</Value> 


6.7.37 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.HelpText 
Table 6 - 107. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.HelpText 


Description A complete description of a how the PCD is implemented. 
Required NO 
Data Type Element — xs:string 


Data Constraints A string that contains one or more lines of text. 


<HelpText> Gets the base address of PCI Express. 
This internal functions retrieves PCI Express 

Examples Base Address via a PCD entry 
PcdPciExpressBaseAddress and returns the base 
address of PCI Express. </HelpText> 


6.7.38 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.HelpText:Lang 


Table 6 - 108. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.HelpText:Lang 
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Description The language code uses an RFC 1766 language code identifier 


Required NO 


Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
ass Lang="fra” 


6.7.39 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError 
<PcdError> 
Choice (One and only one of the following must be selected) 
<ValidvalueList 
Lang=""_ xs:language " {0,1} > 
xs:normalizedString 
</ValidValueList> 
<ValidValueRange> xs:normalizedString </ValidValueRange> 
<Expression> xs:normalizedString </Expression> 
End Choice 
<ErrorNumber> HexNumber </ErrorNumber> {1} 
<ErrorMessage 
Lang="_ xs:language " {0,1} > 
xs:string 
</ErrorMessage> {0,} 
</PcdError> 


Table 6 - 109. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError 


Valid Error messages implemented in this module for the dynamic PcdEx entry. 
Description Only One Error Number per PcdError elements (multiple ErrorMessage entries are 
permitted) and multiple PcdError elements are permitted. 


Required NO 


Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.40 
BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueLi 
st 


Table 6 - 110. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueList 
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Description A list of valid values 


Required NO 


Data Type Element -— xs:normalizedString 


Space Separated list of values. Restricted to the data type of this PCD. Use of the 
L”string” is permitted to specify a UTF-8 text string that will be converted to 
UNICODE (UCS2) formatin the code. Words that are not quoted are considered to 
be enumerations. 


Data Constraints 


<ValidValueList> 0xb0000000 0xb0000001 
</ValidValueList> 

<ValidValueList> “Blue” “Red” “White” 
</ValidValueList> 

<ValidValueList> orange peach apple pear 
</ValidValueList> 


Examples 


6.7.41 
BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueLi 
st:Lang 


Table 6 - 111. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueList:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
ala Constants not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
meee Lang="fra” 


6.7.42 
BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueR 
ange 


Table 6 - 112. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ValidValueRange 


Description The valid range of values using C style nomenclature. 


Required NO 


Data Type Element — xs:normalizedString 
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This is required to be an in-fix logical expression, evaluated left to right, for a range 
of values, using Relational, Equality and Logical Operators (NOT, OR, AND, LT, 
LE, EQ, GT, GE and XOR) that must evaluate to either True or False. The forms 
Data Constraints PcdCName and/or PcdTokenSpaceGuidCName.PcdCName are permitted; if only 
the PcdCName is specified, then the PcdTokenSpaceGuidCName is the same as 
this PCD's TokenSpaceGuidCName. Parentheses are recommended for clarity. All 


other values must be numeric. 


<ValidValueRange> (0xb0000000 LE PcdCNameGoesHere 
) AND (PcdCNameGoesHere GT 0x00010000) 
</ValidValueRange> 

<ValidValueRange> PcdCNameGoesHere LT 0x10001FFF 
AND (PcdCNameGoesHere NOT EQ 0x8000000) 
</ValidValueRange> 


Examples 


6.7.43 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.Expression 
Table 6 - 113. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.Expression 


An in-fix logical expression, evaluated left to right, using Relational, Equality and 
Logical Operators (NOT, AND, OR, GT, GE, EQ, LE, LT and XOR) and parenthesis 
are recommended. The forms PcdCName and/or 
PcdTokenSpaceGuidCName.PcdCName are permitted; if only the PcdCName is 
specified, then the PcdTokenSpaceGuidCName is the same as this PCD's 
TokenSpaceGuidCName. 


Description 


Required NO 
Data Type Element -— xs:normalizedString 
Data Constraints 


<Expression> (NOT gPcdRecoveryMode) AND 


Examples ' 
gPcdS3Resume </Expression> 


6.7.44 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorNumber 
Table 6 - 114. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorNumber 


Description Valid error number per specifications. 
Required YES 
Data Type Element — HexNumber 


Data Constraints A hexadecimal value for the error message as defined by specifications. 


<ErrorNumber>0xb0000000</ErrorNumber> 
<ErrorNumber>0xb0000001</ErrorNumber> 


Examples 
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6.7.45 
BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorMessa 


ge 


Table 6 - 115. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorMessage 


Description An error message for conditional failures of the choices above. 


Required NO 
Data Type Element -— xs:string 
Data Constraints A string that contains one or more lines of text. 


<ErrorMessage> The value specified exceeds the 


Examples 
° maximum value allowed. </ErrorMessage> 


6.7.46 
BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorMessa 


ge:Lang 
Table 6 - 116. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdError.ErrorMessage:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
ee Lang="fra” 


6.7.47 BinaryFiles.BinaryFile.AsBuilt.Librarylnstances 
<LibraryInstances> 
<GUID 
Version=" xs:decimal " {1} > 
RegistryFormatGuid 
</GUID> {1,} 
</LibraryInstances> 


Table 6 - 117. BinaryFiles.BinaryFile.AsBuilt.Librarylnstances 


This section is used to define the Library Class Instances that were linked to the 


Description Module.. 


Required yes 
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Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.7.48 BinaryFiles.BinaryFile.AsBuilt.Librarylnstances.GUID 
Table 6 - 118. BinaryFiles.BinaryFile.AsBuilt.LibraryInstances:GUID 


Description The Registry Format GUID of the library Instance. 
Required YES 

Data Type Element — RegistryFormatGuid 

Data Constraints A string that represents a GUID in registry format. 


Examples <GUID>£d44e603-002a-4b29-9£5£-529e815b6165</GUID> 


6.7.49 BinaryFiles.BinaryFile.AsBuilt.LibraryInstances.GUID:Version 
Table 6 - 119. BinaryFiles.BinaryFile.AsBuilt.Librarylnstances:Version 


Description The Version Number of the Library Instance. 
Required NO 

Data Type Attribute — xs:decimal 

Data Constraints A decimal number 


Examples Version="1.0” 


6.7.50 BinaryFiles.BinaryFile.AsBuilt.BuildFlags 
Table 6 - 120. BinaryFiles.BinaryFile.AsBuilt.BuildFlags 


This section shows the build tool flags that were used during the creation of the 
module. Of specific interest are flags that define values on the compiler command 
line, as well as possible optimizations. Any Attributes to this element are also 
permitted. 


Description 


Required NO 
Data Type Element — Complex, mixed="true" 


Data Constraints None — any attributes and/or content 


<BuildFlags MSVS="8.0”> 
Examples /EXPORT: InitializeDriver=§ (IMAGE _ENTRY_POINT) 
/ALIGN: 4096 /SUBSYSTEM:CONSOLE </BuildFlags> 
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6.7.51 BinaryFiles.BinaryFile.HelpText 


Table 6 - 121. BinaryFiles.BinaryFile.HelpText 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used by the UI tools to provide information about a binary file's use and 
functionality. 


NO 
Element -— xs:string 
A string that contains one or more lines of text. 


<HelpText> Sample driver using HII protocol. 
</HelpText> 


6.7.52 BinaryFiles.BinaryFile.HelpText:Lang 


Table 6 - 122. BinaryFiles.BinaryFile.HelpText:Lang 


Description 
Required 


Data Type 


Data Constraints 


Examples 


The language code uses an RFC 1766 language code identifier. 
NO 
Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 
not specified, the default is "en-us. 


Lang="en-us" 


6.7.53 BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdConsumesRules 


Table 6 - 123. BinaryFiles.BinaryFile.AsBuilt.PcdExValue.PcdConsumesRules 


Description 


Required 


Data Type 


Data Constraints 


Used to clarify when this this PCD is used by the binary module. This elementis a 
Boolean expression containing PCDs names, operators, and PPIs, GUIDs, and 
Protocols marked as CONSUMES or SOMETIMES_CONSUMES. This is required 
to be an in-fix logical expression, evaluated left to right, for a range of values, using 
Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidC Name.PcdCName must be used. Parentheses are 


recommended for clarity. Ifthe PcdConsumesExpression does not evaluate to true, 
then the value of this PCD will be ignored by the binary module. 


NO 
Attribute — xs:normalizedString 


PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 
OR, XOR, EQ, LT, LE, GT and GE. 
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<PcdConsumesRules> gEfiDevicePathProtocolGuid AND 


Examples (TokenSpaceGuid.PcdCName EQ 4) 
</PcdConsumesRules> 


6.8 ModuleSurfaceArea.PackageDependencies 


The following is the description of the ModuleSurfaceArea.PackageDependencies instance: 
<PackageDependencies> 
<Package 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag="_ xs:normalizedString " {0,1} > 
<Description 
Lang="" xs:language " {0,1}> 
xs:string 
</Description> {0,} 


<GUID 
Version="_xs:decimal " {0,1} > 
RegistryFormatGuid 


</GUID> {1} 
</Package> {1,} 
</PackageDependencies> 


Table 6 - 124. ModuleSurfaceArea. PackageDependencies 


Description This element contains a list of all packages a module depends on. 


Required NO 


Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.8.1 PackageDependencies.Package 
Table 6 - 125. PackageDependencies. Package 


Description This Broriey specifies a package required by this module to properly build or 
function. 

Required YES 

Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.8.2 PackageDependencies.Package:SupArchList 
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Table 6 - 126. PackageDependencies.Package:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this package. If 
this attribute is not specified, then this package may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use this package. 


NO 
Attribute — ArchListType 
[A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList=”"IA32” 
SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.8.3 PackageDependencies.Package:SupModList 


Table 6 - 127. PackageDependencies. Package:SupModList 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used by libraries to restrict the set of module types that are allowed to use this 
package dependency. If this attribute is not specified, then this package 
dependency may be used by any module type. If this attribute is specified, then 
only those modules are in a subset of the module types specified by this element 
may use this package dependency. 


NO 
Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, 
PEIM, DXE_CORE,DXE_ DRIVER, DXE_ RUNTIME DRIVER, DXE _ 
SAL_DRIVER, DXE_SMM_ DRIVER, TOOL, UEFI_DRIVER, UEFI_ 
RUNTIME DRIVER, UEFI_APPLICATION, USER DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE _ 
DRIVER" 


6.8.4 PackageDependencies.Package:FeatureFlag 


Table 6 - 128. PackageDependencies.Package:FeatureFlag 


Description 


Used to restrict the use of this package. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
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must evaluate to either True or False. The form 

PcdTokenSpaceGuidC Name.PcdCName is required.. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
package may only be used if the Boolean expression evaluates to true. 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=”"true” 


6.8.5 PackageDependencies.Package.Description 
Table 6 - 129. PackageDependencies.Package.Description 


Description This element describes the reason for the dependency. 
Required NO 

Data Type Element -— xs:string 

Data Constraints A string that contains one or more lines of text. 


<Description> Requires Status Code Library 


Examples ; : : 
Functions </Description> 


6.8.6 PackageDependencies.Package.Description:Lang 
Table 6 - 130. PackageDependencies.Package.Description:Lang 


Description The language code uses an RFC 1766 language code identifier. 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraint 
eens not specified, the default is "en-us. 


Examples Lang="en-us" 


6.8.7 PackageDependencies.Package.GUID 
Table 6 - 131. PackageDependencies.Package.GUID 


Description The language code uses an RFC 1766 language code identifier. 


Required NO 
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Data Type Element — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is "en-us. 


Examples Lang="en-us" 


6.8.8 PackageDependencies.Package.GUID:Version 
Table 6 - 132. PackageDependencies. Package.GUID:Version 


This attribute specifies the version of a package required by this module to 
properly build or function. If this attribute is listed, ONLY the specific GUID/Version 
package can be used. If this attribute is not specified, the highest version ofa 
package can be used. 


Description 


Required NO 


Data Type Attribute — xs:decimal 


Data Constraints [0-9]+((\.)?[0-9}+)* 


Version="1.0” 


exembles Version="1.10” 


6.9 ModuleSurfaceArea.Guids 


It is permissible for a module to list a GUID twice, once for CONSUMES and another for 
PRODUCES, if and only if the GUID type is transformed by the module. 


The following is the description of the ModuleSurfaceArea . Guids instance: 
<Guids> 
<GuidCName> ... </GuidCName> {1,} 
</Guids> 


<GuidCName 
Usage="UsageType " {1} 
GuidType=" GuidListType " {1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
<CName> xs:NCName </CName> {1} 
<GUID> RegistryFormatGuid </GUID> {0,1} 
<VariableName> xs:normalizedString </VariableName> {0,1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
<SometimesConsumes> ConsumesExpression 
</SometimesConsumes> {0,} 
</GuidCName> 
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Table 6 - 133. ModuleSurfaceArea. Guids 


Description This is a list of Guids produced or consumed by this module. 


Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.9.1 Guids.GuidCName 
Table 6 - 134. Guids.GuidCName 


This element specifies information about Guids used by, or produced by this 
Description module. The GUID CName specified in this section must be defined in a package 
declaration. Protocols and PPls do not need to be listed in this section. 


Required YES 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.9.2 Guids.GuidCName:Usage 
Table 6 - 135. Guids.GuidCName:Usage 


Description This element specifies the GUID Usage. 
Required YES 
Data Type Attribute -— UsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 
CONSUMES or SOMETIMES PRODUCES 

PRODUCES means that a module will produce a GUID that does not fit into the 
defined PROTOCOL or PPI types. 

CONSUMES means that a module may use this GUID that does not fit into the 
defined PROTOCOL or PPI types. 

UNDEFINED - implies that a GUID is used, but the package creator does not 
know how it used. 


Data Constraints 


Usage=” PRODUCES” 
Usage=”"CONSUMES” 


Examples 
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Parameters 
CONSUMES 
The module will use the named GUID. For GUID type (specified in the Type 
attribute) of: 


e Event - CONSUMES means that the module has an event waiting to be signaled (i.e., the 
module registers a notification function and calls the function when it is signaled. 


System Table - this means that the module will use a GUIDed entry in the system 
table. 


¢ EFI Variable - this means that the module may use the variable entry. 
¢ Formset - the formset may be registered into HII by this module. 


* TokenSpaceGuid - this means that an Token Space GUID will be required for PCD 
entries used in this module. 


¢ Hob - this means that a HOB may need to be present in the system. 


¢ File/FV - this means that a file must be present in an FV, such as a module that loads a 
processor microcode patch file. 


¢ GUID - this means that a module may use this GUID that does not fit into the defined 
GUID types. 


PRODUCES 
This module always produces a named GUID. For GUID type (specified in the 
Type attribute) of: 
* Boot Modes - this means that the module will change the boot mode. 
¢ Event - this means that module will signal all events in an event group. 


¢ System Table - this means that the module will produce a GUIDed entry in the system 
table. 


¢ EFI Variable - this means that the module will write the variable. 
* Formset - PRODUCES is not valid for this GUID type. 

¢ TokenSpaceGuid - PRODUCES is not valid for this GUID type. 
¢ Hob - this means that the HOB will be produced by the module. 


¢ File/FV - this means that a module creates a file that is present in an FV, such as a file 
that contains a microcode patch. 


¢ GUID - this means that a module will produce a GUID that does not fit into the defined 
PROTOCOL, PPI or GUID types. 


6.9.1 Guids.GuidCName:GuidType 


Table 6 - 136. Guids.GuidCName:GuidType 


Description This element specifies the type of GUID. 


Required YES 
Data Type Attribute — GuidListType 


Data Constraints One or more of the enumerated values: Event, File, FV, GUID, HII, HOB, 
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SystemTable, TokenSpaceGuid or Variable. 
UNDEFINED - implies that a GUID is used, but the package creator does not 
know the GUID's type. 


GuidType="Event” 
GuidType=”TokenSpaceGuid” 


Examples 


Parameters 
Fivent 


The functions that make up the Event used during preboot to create, close, signal, 
and wait for events as defined in the UEFI specification. 

SystemTable 
As defined in the PI Specification, the UEFI System Table is passed to every 
executable image in the DXE phase. The UEFI System Table contains a pointer to 
the following: 
"UEFI Boot Services Table" 
"UEFI Runtime Services Table" 
It also contains pointers to the console devices and their associated I/O protocols. In 
addition, the UEFI System Table contains a pointer to the UEFI Configuration 
Table, which contains a list of GUID/pointer pairs. The UEFI Configuration Table 
may include tables such as the "DXE Services Dependencies", HOB list, ACPI 
table, SMBIOS table, and SAL System table. 
The UEFI Boot Services Table contains services to access the contents of the 
handle database. The handle database is where protocol interfaces produced by 
drivers are registered. Other drivers can use the UEFI Boot Services to look up 
these services produced by other drivers. 

Variable 
The UEFI and PI specifications define UEFI Variables as key/value pairs that 
consist of identifying information plus attributes (the key) and arbitrary data (the 
value). Variables are intended for use as a means to store data that is passed 
between the UEFI environment implemented in the platform and UEFI OS loaders 
and other applications that run in the UEFI environment. 

Hit 


These GUIDs refer to the core code and services that are required for an 
implementation of the Human Interface Infrastructure (HII). 

TokenSpaceGuid 
These GUIDs are used as a definition of a group of Platform Configuration 
Database (PCD) entries. Different packages of PCDs are identified by a Token 
Space GUID. Within each of these packages, the individual PCD's Token number is 
unique. PCDs are then identified by the Token Space GUID and the PCD's Token 
number. 


HOB 


aOAI = 
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These GUIDs are for manipulation of the PEI-DXE Hand Off Blocks. The HOB 
types are defined in the PI Specification. 


GUID 


These are GUIDs that do not fall into PPI, PROTOCOL or any of the above 
definitions. 


6.9.2 Guids.GuidCName:SupArchList 


Table 6 - 137. Guids.GuidCName:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this GUID. If 
this attribute is not specified, then this GUID may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use this GUID. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=“IA32” 
Examples SupArchList=“IA32 X64” 
SupArchList=“EBC IPF X64” 


6.9.3 Guids.GuidCName:SupModList 
Table 6 - 138. Guids.GuidCName:SupModList 


Used by libraries to restrict the set of module types that are allowed to use this 
guid. If this attribute is not specified, then this guid may be used by any module 
type. If this attribute is specified, then only those modules are in a subset of the 
module types specified by this element may use this guid. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 


spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_ SAL _ 

DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI __ 

RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER" 


Examples 


6.9.4 Guids.GuidCName:FeatureFlag 
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Table 6 - 139. Guids.GuidCName:FeatureFlag 


Used to restrict the use of this GUID. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False.The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
GUID may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints 
and GE. 


Examples FeatureFlag=” true” 


6.9.5 Guids.GuidCName.CName 
Table 6 - 140. Guids.GuidCName.CName 


Description This element specifies the C name of the GUID. 
Required YES 

Data Type Element — xs:NCName 

Data Constraints Must be a valid GUID C name 


<CName> gEfiEventReadyToBootGuid </CName> 


Ese <CName>gEfiConsoleInDeviceGuid</CName> 


6.9.6 Guids.GuidCName.VariableName 
Table 6 - 141. Guids.GuidCName.VariableName 


Description This element specifies the Variable name for a Variable GUID. 
Required NO 
Data Type Element -— xs:normalizedString 


Must be a valid Variable Name in either Hex Array (litle endian) or L’string” (C 


Data Constraint 
cai ad style.) This elementis only valid for an EFI Variable GUID type. 


<VariableName> L”Reset” </VariableName> 
Examples <VariableName> 0x52 0x00 0x65 0x00 0x73 0x00 0x65 
0x00 0x74 0x00 </VariableName> 
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6.9.7 Guids.GuidCName.GUID 


Table 6 - 142. Guids.GuidCName.GUID 


Description 


Required 


Data Type 


Data Constraints 


Examples 


This element specifies the GUID value of a GUID. 
NO 

Element — RegistryFormatGuid 

Registry format GUID of a GUID. 


<GUID>5e0e9358-46b6-4ae2-8218 -4ab8b9bbdcec</GUID> 
<GUID>b6ec423c-21d2-490d-85c6-dd5864eaa674</GUID> 


6.9.8 Guids.GuidCName.HelpText 


Table 6 - 143. Guids.GuidC Name. HelpText 


Description 
Required 
Data Type 


Data Constraints 


Examples 


This element specifies the HelpText describing correct usage of the GUID 
NO 

Element -— xs:string 

A string that contains one or more lines of text. 


<HelpText> Check the device handle, if it isa 
hot plug device, do not put the device path into 
ConInDev, and install gEfiConsoleInDeviceGuid to 
the device handle directly. 

The policy is, make hot plug device plug in and 
play immediately. </HelpText> 


6.9.9 Guids.GuidCName.HelpText:Lang 


Table 6 - 144. Guids.GuidCName.HelpText:Lang 


Description 
Required 


Data Type 


Data Constraints 


Examples 


The language code uses an RFC 1766 language code identifier 
NO 
Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 
not specified, the default is “en-us.’ 


Lang="en-us” 


6.9.10 Guids.GuidCName.SometimesConsumes 


Table 6 - 145. Guids.GuidCName.SometimesConsumes 
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Used to clarify when this this GUID is consumed by the driver. This elementis a 
Boolean expression containing PCDs names, operators, and PPIs, GUIDs, and 
Protocols marked as CONSUMES or SOMETIMES_ CONSUMES. This is required 
to be an in-fix logical expression, evaluated left to right, for a range of values, using 

Description Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidC Name.PcdCName must be used. Parentheses are 
recommended for clarity. Each SometimesConsumes expression must evaluate to 
true for this module to function. 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 


Dat traint 
ata Constraints | oR xOR, EQ, LT, LE, GT and GE. 


<SometimesConsumes> gEfiDevicePathProtocolGuid 
Examples AND (TokenSpaceGuid.PcdCName EQ 4) 
</SometimesConsumes> 


6.10 ModuleSurfaceArea.Protocols 


The following is the description of the ModuleSurfaceArea. Protocols instance: 
<Protocols> 
<Protocol 
Usage="" ProtocolUsageType " {1} 
Notify="_xs:boolean " {0,1} 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag="_ xs:normalizedString " {0,1} > 
<CName> xs:NCName </CName> {1} 
<GUID> RegistryFormatGuid </GUID> {0,1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
<ByStart> ByStartExpression </ByStart> {0,} 
<SometimesConsumes> ConsumesExpression 
</SometimesConsumes> {0,} 
</Protocol> {1,} 
</Protocols> 


Table 6 - 146. ModuleSurfaceArea.Protocols 


Description This element contains a list of all Protocols a module depends on or produces. 


Required NO 


Data Type Element — Complex 
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Data Constraints N/A 


Examples N/A 


6.10.1 Protocols.Protocol 
Table 6 - 147. Protocols.Protocol 


This element specifies information about a Protocol used or produced by this 
Description module. The CName specified in this section must be defined in a package 
declaration. 


Required YES 
Data Type Element — ComplexType 
Data Constraints Only child elements are allowed within the element 


Examples N/A 


6.10.2 Protocols.Protocol:Usage 
Table 6 - 148. Protocols.Protocol:Usage 


Description This attribute specifies whether the Protocol is needed or produced by the module. 
Required YES 
Data Type Attribute — ProtocolUsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 


CONSUMES, SOMETIMES PRODUCES, TO START orBY_ START. 
UNDEFINED - implies thata Protocol is used, but the package creator does not 
know how it used. 


Data Constraints 


Usage=” PRODUCES” 


Exampl 
ae Usage=”CONSUMES” 


Parameters 
CONSUMES 
This module does not install the protocol, but needs to locate a protocol. Not valid if 
the Notify attribute is true. 
PRODUCES 
This module will install this protocol. Not valid if the Notify attribute is true. 
SOMETIMES CONSUMES 


This module does not install the protocol, but may need to locate a protocol under 
certain conditions, (such as if it is present.) If the Notify attribute is set, then the 
module will use the protocol, named by GUID, via a registry protocol notify 
mechanism. 
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SOMETIMES _ PRODUCES 
This module will install this protocol under certain conditions. Not valid if the Notify 
attribute is true. 

TO_START 
The protocol is consumed by a Driver Binding protocol Start function. Thus the 


protocol is used as part of the UEFI driver model. Not valid if the Notify attribute is 
true. 


BY START 


The protocol is produced by a Driver Binding protocol Start function. Thus the 
protocol is used as part of the UEFI driver model. Not valid if the Notify attribute is 
true. 


6.10.3 Protocols.Protocol:Notify 
Table 6 - 149. Protocols.Protocol:Notify 
This attribute specifies whether this is a Protocol or ProtocolNotify. If set, then the 


Description module will use this protocol, named by GUID, via a registry protocol notify 
mechanism. 


Required NO 


Data Type Attribute — xs:boolean 


Only required for ProtocolNotify, in which the value must be set to true. The default 


Data Constraints 
(non-specified) value is false. 


Examples Notify="true” 


6.10.4 Protocols.Protocol:SupArchList 
Table 6 - 150. Protocols.Protocol:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this protocol. If 
this attribute is not specified, then this protocol may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that support a 
subset of the CPU architectures specified by this element may use this protocol. 


Description 


Required NO 
Data Type Attribute — ArchListType 


Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=‘“IA32” 
Examples SupArchList=“IA32 X64” 
SupArchList=“EBC IPF X64” 


6.10.5 Protocols.Protocol:SupModList 


eDAT = 
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Table 6 - 151. Protocols.Protocol:SupModList 


Used by libraries to restrict the set of module types that are allowed to use this 
guid. If this attribute is not specified, then this guid may be used by any module 
type. If this attribute is specified, then only those modules are in a subset of the 
module types specified by this element may use this guid. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL _ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER" 


Examples 


6.10.6 Protocols.Protocol:FeatureFlag 
Table 6 - 152. Protocols.Protocol:FeatureFlag 


Used to restrict the use of this protocol. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidCName.PcdCName must be used. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
protocol may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Dat traint 
ata Constraints and GE. 


Examples FeatureFlag=”"false” 


6.10.7 Protocols.Protocol.CName 


Table 6 - 153. Protocols.Protocols.CName 


Description This element specifies the C name of the Protocol. 
Required YES 
Data Type Element — xs:NCName 
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Data Constraints Must be a valid GUID C name 


<CName>gEfiBlockIoProtocolGuid</CName> 


ExeInples <CName> gEfiBlockIoProtocolGuid </CName> 


6.10.8 Protocols.Protocol.GUID 
Table 6 - 154. Protocols.Protocol.GUID 


Description This element specifies the GUID value of a Protocol. 


Required NO 


Data Type Element — RegistryFormatGuid 


Data Constraints Registry format GUID of a Protocol. 


<GUID>5e0e9358-46b6-4ae2-8218 -4ab8b9bbdcec</GUID> 


exaliplcs <GUID>b6ec423c-21d2-490d-85c6-dd5864eaa674</GUID> 


6.10.9 Protocols.Protocol.HelpText 
Table 6 - 155. Protocols.Protocol.HelpText 


Description This element specifies the HelpText describing correct usage of the Protocol 
Required NO 

Data Type Element -— xs:string 

Data Constraints A string that contains one or more lines of text. 


<HelpText> The Block I/O Protocol provides 
services to read, write, and flush block to a 
block oriented storage device such as a hard 
Examples disk, CD-ROM, DVD, and floppy. This Protocol is 
available to all CPU types, but is restricted for 
use by DXE_DRIVER, UEFI_DRIVER, and UEFI_ 
APPLICATION module types. </HelpText> 


6.10.10 Protocols.Protocol.HelpText:Lang 
Table 6 - 156. Protocols.Protocol.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 


Required NO 
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Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.10.11 Protocols.Protocol.ByStart 
Table 6 - 157. Protocols.ProtocolByStart 


This element is only used if the Usage attribute is BY_START. 
Used to clarify the requirements to produce this protocol in the driver's Driver 
Binding protocol Start function. This element is a Boolean expression containing 
PCDs names, Protocols marked as TO_START for this module, and operators. This 
is required to be an in-fix logical expression, evaluated left to right, for a range of 
Description values, using Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, 
EQ, GT, GE and XOR) that must evaluate to either True or False. To specify a PCD, 
the form PcdTokenSpaceGuidCName.PcdCName must be used. Parentheses are 
recommended for clarity. If the usage attribute is BY_START and there is at least 
one ByStart element then the protocol will be produced BY_START only if at least 
one ByStart element expression evaluates to true. 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators: NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


<ByStart> gEfiDevicePathProtocolGuid AND 
Examples (gE£fiUsb2HcProtocolGuid OR gEfiUsbHcProtocolGuid) 
</ByStart> 


6.10.12 Protocols.Protocol.SometimesProduces 


Table 6 - 158. Protocols.Protocol.SometimesProduces 


Used to clarify when this this protocol, which must be marked with usage of 
SOMETIMES_PRODUCED, is produced by the driver. This element is a Boolean 
expression containing PCDs names, operators, and PPls, GUIDs, and Protocols 
marked as CONSUMES or SOMETIMES_CONSUMES. This is required to be an 
in-fix logical expression, evaluated left to right, for a range of values, using 
Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidCName.PcdCName must be used. Parentheses are 
recommended for clarity. If any SometimesProduces expression evaluates to true, 
then this protocol is produced. 


Description 
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Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 


Data Constraints | GR XOR, EO, LT, LE, GT and GE. 


<SometimesConsumes> gEfiDevicePathProtocolGuid 
Examples AND (TokenSpaceGuid.PcdCName EQ 4) 
</SometimesProduces> 


6.11 ModuleSurfaceArea.PPIs 


The following is the description of the ModuleSurfaceArea. PPIs instance: 
<PPIs> 
<Ppi 
Usage="" UsageType " {1} 
Notify=""xs:boolean " {0,1} 
SupArchList=" ArchListType " {0,1} 
SupModList_” ModuleListType “ {0,1} 
FeatureFlag="xs:normalizedString " {0,1} > 
<CName> xs:NCName </CName> {1} 
<GUID> RegistryFormatGuid </GUID> {0,1} 
<HelpText 
Lang=""_xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
<SometimesConsumes> ConsumesExpression 
</SometimesConsumes> {0,} 
</Ppi> {1,} 
</PPIs> 


Table 6 - 159. ModuleSurfaceArea.PPlIs 


Description This element contains a list of all PPIs a module depends on or produces. 


Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.11.1 PPls.Ppi 
Table 6 - 160. PPls.Ppi 


This element specifies the C name of a Ppi required by this module to properly 
build or function, or produced by this module. 


Description 
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Required YES 


Data Type Element — ComplexType 


Data Constraints N/A 


Examples N/A 


6.11.2 PPls.Ppi:Usage 
Table 6 - 161. PPls.Ppi:Usage 


Description This attribute specifies whether the Ppi is required or produced by the module. 
Required YES 
Data Type Attribute - UsageType 


One of the enumerated values: CONSUMES, PRODUCES, SOMETIMES _ 


CONSUMES or SOMETIMES PRODUCES. 
UNDEFINED - implies thata PPlis used, but the package creator does not know 
how it used. 


Data Constraints 


Usage=” PRODUCES” 


Examples Usage=”"CONSUMES” 


Parameters 
CONSUMES 


This module does not install the PPI, but needs to locate a PPI. Not valid if the 
Notify attribute is true. 


PRODUCES 

This module will load this PPI. Not valid if the Notify attribute is true. 
SOMETIMES CONSUMES 

This module does not install the PPI, but may need to locate a PPI under certain 


conditions or execution paths. If the Notify attribute is set, then the module will use 
the PPI, named by GUID, via a registry PPI notify mechanism. 


SOMETIME PRODUCES 


This module will load this PPI under certain conditions or execution paths. Not valid 
if the Notify attribute is true. 


6.11.3 PPls.Ppi:Notify 


Table 6 - 162. Ppis.Ppi:Notify 


This attribute specifies whether this is a Ppi or PpiNotify. If set to, the module 


D ipti 
a a requires or consumes a PPI, named by GUID, via a register PPI notify mechanism. 
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Required NO 


Data Type Attribute — xs:boolean 


Only required for PpiNotify, in which the value must be set to true. The default (non- 


Data Constraints : F 
specified) value is false. 


Examples Notify="true” 


6.11.4 PPls.Ppi:SupArchList 
Table 6 - 163. PPIls.Ppi:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this Ppi. If this 
attribute is not specified, then this Ppi may be used with any CPU Architecture. If 
this attribute is specified, then only those modules that support a subset of the CPU 
architectures specified by this element may use this Ppi. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList=“IA32” 
Examples SupArchList=“IA32 X64” 
SupArchList=“EBC IPF X64” 


6.11.5 PPls.Ppi:SupModList 
Table 6 - 164. PPls.Ppi:SupModList 


Used by libraries to restrict the set of module types that are allowed to use this ppi. 
If this attribute is not specified, then this ppi may be used by any module type. If this 
attribute is specified, then only those modules are in a subset of the module types 
specified by this element may use this ppi. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 


spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL _ 

DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 

RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER" 


Examples 
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6.11.6 PPls.Ppi:FeatureFlag 
Table 6 - 165. PPls.Ppi:FeatureFlag 


Used to restrict the use of this Ppi. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this Ppi 
may only be used if the Boolean expression evaluates to true. 


Description 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=”" false” 


6.11.7 PPls.Ppi.CName 


Table 6 - 166. PPls.Ppi.CName 


Description This element specifies the C name of the Ppi. 

Required YES 

Data Type Element — xs:NCName 

Data Constraints Must be a valid C name. 

exsiipiés <CName>gEfiDxeIp1PpiGuid</CName> 
<CName>gEfiPeiStallPpiGuid</CName> 

6.11.8 PPls.Ppi.GUID 


Table 6 - 167. PPls.Ppi.GUID 
Description This element specifies the GUID value of a Ppi. 
Required NO 
Data Type Element — RegistryFormatGuid 


Data Constraints Registry format GUID of a Ppi. 


<GUID>5e0e9358-46b6-4ae2-8218 -4ab8b9bbdcec</GUID> 
<GUID>b6ec423c-21d2-490d-85c6-dd5864eaa674</GUID> 


Examples 


6.11.9 PPls.Ppi.HelpText 
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Table 6 - 168. PPls.Ppi.HelpText 


Description This element specifies the HelpText describing correct usage of the Ppi 


Required NO 


Data Type Element -— xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText> The Block I/O Ppi provides services to 

read, write, and flush block to a block oriented 

storage device such as a hard disk, CD-ROM, DVD, 
Examples and floppy. This Ppi is available to all CPU 

types, but is restricted for use by DXE_ DRIVER, 

UEFI_ DRIVER, and UEFI_APPLICATION module 

types .</HelpText> 


6.11.10 PPls.Ppi.HelpText:Lang 
Table 6 - 169. PPIs.Ppi.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
ale Consvelnts not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.11.11 PPls.Ppi.SometimesConsumes 
Table 6 - 170. Guids.GuidCName.SometimesConsumes 


Used to clarify when this this PPI is consumed by the driver. This elementis a 
Boolean expression containing PCDs names, operators, and PPIs, GUIDs, and 
Protocols marked as CONSUMES or SOMETIMES_CONSUMES. This is required 
to be an in-fix logical expression, evaluated left to right, for a range of values, using 

Description Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidCName.PcdCName must be used. Parentheses are 
recommended for clarity. Each SometimesConsumes expression must evaluate to 
true for this module to function.n. 


Required NO 


Data Type Attribute — xs:normalizedString 
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PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 


Dat fraint 
ata Constraints | oR XOR, EQ, LT, LE, GT and GE: 


<SometimesConsumes> gEfiDevicePathProtocolGuid 
Examples AND (TokenSpaceGuid.PcdCName EQ 4) 
</SometimesConsumes> 


6.12 ModuleSurfaceArea.Externs 


The following is the description of the ModuleSurfaceArea.Externs instance: 
<Externs> 
<Extern 
SupArchList=" ArchListType " {0,1} 
SupModList=” ModuleListType “ {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
Start Choice 
Start Sequence 
<EntryPoint> xs:NCName </EntryPoint> {0,1} 
<UnloadImage> xs:NCName </UnloadImage> {0,1} 
End Sequence 
Start Sequence 
<Constructor> xs:NCName </Constructor> {0,1} 
<Destructor> xs:NCName </Destructor> {0,1} 
End Sequence 
End Choice 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
</Extern> {1,} 
</Externs> 


Table 6 - 171. ModuleSurfaceArea.Externs 


Description This section defines additional information about dirvers and libraries. 


Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


6.12.1 Externs.Extern 


Table 6 - 172. Externs.Extern 
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Description These elements specify multiple setions of additional information. 


Required YES 
Data Type Element — Complex 


Multiple Instances of Extern Statements are permitted, and atleast one of the 


Data Constraints 
following sub-elements must be specified. 


Examples N/A 


6.12.2 Externs.Extern:SupArchList 
Table 6 - 173. Externs.Extern:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this Extern. If 
this attribute is not specified, then this Extern may be used with any CPU 
Architecture. If this attribute is specified, then only those modules that supporta 
subset of the CPU architectures specified by this element may use this Extern. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList="IA32” 
Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.12.3 Externs.Extern:SupModList 
Table 6 - 174. Externs.Extern:SupModList 


Used to restrict the set of module types that are allowed to use this Extern. If this 
attribute is not specified, then this Extern may be used with any module type. If this 
attribute is specified, then only those modules that support a subset of the module 
types specified by this element may use this Extern. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 


Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE _ 
DRIVER" 


Examples 
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6.12.4 Externs.Extern:FeatureFlag 


Table 6 - 175. Externs.Extern:FeatureFlag 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used to restrict the use of this Extern. This attribute is a Boolean expression 
containing PCD Feature Flag names and operators. This is required to be an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False.The form 

PcdTokenSpaceGuidC Name.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
Extern may only be used if the Boolean expression evaluates to true. 


NO 
Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 
and GE. 


FeatureFlag=”"true” 


6.12.5 Externs.Extern.EntryPoint 


Table 6 - 176. Externs.Extern.EntryPoint 


Description 


Required 
Data Type 


Data Constraints 


Examples 


This element specifies the Module Entry Point of the Module. C name of the 
module entry point function. The PE32 image entry point goes into a library and the 
library calls this entry pointin the module. 


NO 
Element — xs:NCName 
Must be a valid C name. Valid for drivers only. 


<EntryPoint> GenericMemoryTestEntryPoint 
</EntryPoint> 
<EntryPoint>BarEntry</Entry Point 


6.12.6 Externs.Extern.Unloadimage 


Table 6 - 177. Externs.Extern.Unloadimage 


Description 


Required 


Data Type 


This element specifies the Module Unload Image of the Module. C name of the 
module unload function. This function is optional as a module is not required to 
support unload. 


NO 


Element — xs:‘NCName 
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Data Constraints Must be a valid C name. Valid for drivers only. 


<UnloadImage>FooUnload</UnloadImage> 


Examines <UnloadImage>BarUnload</UnloadImage> 


6.12.7 Externs.Extern.Constructor 
Table 6 - 178. Externs.Extern.C onstructor 


This element specifies the Constructor of a Library. While most library instances do 
not produce Constructors, those that do, should include the C name here. Library 

Description constructors are called before the module entry point function is executed. Any 
library that performs initialization (such as the Dxe SMM report status code library) 
should publish a constructor. 


Required NO 
Data Type Element — xs:NCName 
Data Constraints Must be a valid C name. Valid for a Library Module 


<Constructor>BarInit</Constructor> 


E | : 
Aol <Constructor>FooInit</Constructor> 


6.12.8 Externs.Extern.Destructor 
Table 6 - 179. Externs.Extern.Destructor 


This element specifies the Destructor of a Library. While most library instances do 
not produce Destructors, those that do, should include the C name here. Library 

Description destructors are called after the module entry point function is executed. Any library 
that performs a cleanup (such as the UEFI Runtime library) should publish a 
destructor. 


Required NO 
Data Type Element — xs:NCName 
Data Constraints Must be a valid C name. Valid for a Library Module 


<Destructor>BarkKill</Destructor> 


E | sj 
a aa <Destructor>Fookill</Destructor> 


6.12.9 Externs.Extern.HelpText 
Table 6 - 180. Externs.Extern.HelpText 


This element specifies the HelpText describing the module EntryPoint, 
UnloadImage, Constructor or Destructor. 


Description 
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Required NO 


Data Type Element — xs:string 


Data Constraints A string that contains one or more lines of text. 


<HelpText> GenericMemoryTestEntryPoint is the 
generic memory test driver's entry point, it can 
initialize private data 

to default value. </HelpText> 


Examples 


6.12.10 Externs.Extern.HelpText:Lang 
Table 6 - 181. Externs.Extern.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.13 ModuleSurfaceArea.PcdCoded 


Note that if the Binary attribute was set for the ModuleSurfaceArea, then only include the PCDs 
that are of type: PatchPcd, Pcd and/or PcdEx. The "DefaultValue" becomes the real value used 
during the build of the module in the context of a platform and must be set. The PcdItemType must 
be set to the way the platform used the PCD. If a binary is present, along with the sources, and the 
Binary attribute is NOT set, then this is a standard section, and the Pcd sections of the AsBuilt 
must be used to show how the binary was created. 


The following is the description of the ModuleSurfaceArea .PcdCoded instance: 


<PcdCoded> 
<PcdEntry 
PcdItemType="" PcdItemTypes " {1} 
PcdUsage="_ xs:NCName " {1} 
SupArchList=" ArchListType " {0,1} 
SupModList=” ModuleListType “ {0,1} 
FeatureFlag=" xs:normalizedString " {0,1} > 
<CName> xs:NCName </CName> {1} 
<TokenSpaceGuidCName> xs:NCName </TokenSpaceGuidCName> {1} 
<DefaultValue> xs:normalizedString </DefaultValue> {0,1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs:string 
</HelpText> {0,} 
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<PcdConsumesRules> PcdConsumesExpression 
</PcedConsumesRules> {0,} 
</PedEntry> {1,} 
</PcdCoded> 


Table 6 - 182. ModuleSurfaceArea.PcdC oded 


Description The list of PCDs the module was coded to use. 


Required NO 


Data Type Element - Complex 
Data Constraints N/A 


Examples N/A 


6.13.1 PcdCoded.PcdEntry 


Table 6 - 183. ModuleSurfaceArea.PcdCoded.PcdEntry 


Description Defines how the module was coded for this PCD Entry. 
Required YES 

Data Type Element - Complex 

Data Constraints N/A 

Examples N/A 


6.13.2 PcdCoded.PcdEntry:PcditemType 
Table 6 - 184. PcdCoded.PcdEntry:PcdltemType 


Description Define the PCD type for this entry. 
Required YES 
Data Type Attribute — PcdltemTypes 


Must contain one of the following Enumerated Data Types: FeaturePcd, 


Dat traint 
af Constalbits FixedPcd, PatchPcd, Pcd or PcdEx. 


PcdI temType="FixedPcd” 
Examples PcditemType="FixedPcd PatchPcd” 
PcdItemType=”Pcd” 


Parameters 
FeaturePcd 


The FeaturePcd is used as a boolean flag to enable or disable specific features. 
FixedPcd 


The FixedPcd is used to flag the platform integrator that the module requires a static 
mapping of the PCD. 
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PatchPcd 


The PatchPcd is used to flag the platform integrator that the module requires a 
mapping of the PCD where the value can be altered in the binary (the value needs to 
be a known offset,, with information about data size and type available. 


Ped 
The Pcd is used to flag the platform integrator that the module may be used as a 
Fixed Pcd, Patch Ped, or a Dynamic PCD - where the value is registered in a PCD 
database within the system and the value can be found/set using either a PCD PPI or 
PCD Protocol driver. The platform integrator should select how he wants to use the 
PCD. 

PcdEx 


The PcdEx is used to flag the platform integrator that the module is coded for a 
Dynamic PCD - where the value is registered in a PCD database within the system 
and the value can be found/set using either a PCD PPI or PCD Protocol driver. 


6.13.3 PcdCoded.PcdEntry:PcdUsage 
Table 6 - 185. PcdCoded.PcdEntry:PcdUsage 


Description This attribute specifies whether the Pcd is required or produced by the module. 
Required YES 
Data Type Attribute — xs:‘NCName 


One of the enumerated values: CONSUMES, SOMETIMES CONSUMES, 


PRODUCES or SOMETIMES PRODUCES. For PcditemTypes of FeatureFlag, 
Data Constraints this entry mustbe CONSUMES. 

UNDEFINED - implies thata PCD is used, but the package creator does not 

know how it used. 


PcdUsage=” PRODUCES” 


Esmee PcdUsage=” CONSUMES” 


Parameters 
CONSUMES 
This module always gets the PCD entry. 
PRODUCES 
The module always sets the PCD entry. 
SOMETIMES CONSUMES 
The module gets the PCD entry under certain conditions or execution paths. 
SOMETIMES _ PRODUCES 


The module sets the PCD entry under certain conditions or execution paths. 


6.13.4 PcdCoded.PcdEntry:SupArchList 
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Table 6 - 186. PcdCoded.PcdEntry:SupArchLis 


Used to restrict the set of CPU Architectures that are allowed to use this PCD. If this 
attribute is not specified, then this PCD may be used with any CPU Architecture. If 
this attribute is specified, then only those modules that support a subset of the CPU 
architectures specified by this element may use this PCD. 


Description 


Required NO 
Data Type Attribute — ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList="IA32” 
Examples SupArchList="IA32 X64” 
SupArchList="EBC IPF X64” 


6.13.5 PcdCoded.PcdEntry:SupModList 
Table 6 - 187. PcdCoded.PcdEntry:SupModLis 


Used by libraries to restrict the set of module types that are allowed to use this pcd. 
If this attribute is not specified, then this pcd may be used by any module type. If 
this attribute is specified, then only those modules are in a subset of the module 
types specified by this element may use this pcd. 


Description 


Required NO 
Data Type Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE _ 
DRIVER" 


Examples 


6.13.6 PcdCoded.PcdEntry:FeatureFlag 
Table 6 - 188. PcdCoded.PcdEntry:FeatureFlag 
Used to restrict the use of this PCD. This attribute is a Boolean expression 


containing PCD Feature Flag names and operators. This is required to be an in-fix 
Description logical expression, evaluated left to right, for a range of values, using Relational, 


Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The forms PcdCName and/or 
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PcdTokenSpaceGuidCName.PcdCName are permitted; if only the PcdCName is 
specified, then the PcdTokenSpaceGuidCName is the same as this PCD's 
TokenSpaceGuidCName. Parentheses are recommended for clarity. If this attribute 
is specified, then this PCD may only be used if the Boolean expression evaluates 
to true. 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag=”"true” 


6.13.7 PcdCoded.PcdEntry.CName 
Table 6 - 189. PcdCoded.PcdEntry.CName 


Description This element specifies the C name of the PCD entry 

Required YES 

Data Type Element — xs:NCName 

Data Constraints A valid C name listed in a declaration file that declares the PCD. 


<CName>PcdMaximumUnicodeStringLength</CName> 


amples <CName> PcdMaximumAsciiStringLength </CName> 


6.13.8 PcdCoded.PcdEntry. TokenSpaceGuidCName 
Table 6 - 190. PcdCoded.PcdEntry. TokenSpaceGuidC Name 


This element specifies the C name of the PCD defined TokenSpaceGuidCName. 
Description The actual GUID value must be declared in a package declaration file that may not 
be part of this distribution. 


Required YES 
Data Type Element — xs:NCName 


Data Constraints 


<TokenSpaceGuidCName> gEfiMdePkgTokenSpaceGuid 
</TokenSpaceGuidCName> 


Examples 


6.13.9 PcdCoded.PcdEntry.DefaultValue 


Table 6 - 191. PcdCoded.PcdEntry.DefaultValue 
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Description This element specifies the C name of the PCD defined TokenSpaceGuidCName 


Required NO 
Data Type Element -— xs:normalizedString 
Data Constraints Any valid string of printable characters. 


<DefaultValue>0x0048 0x0052</DefaultValue> 


Examples <DefaultValue>LBigBear</DefaultValue> 


6.13.10 PcdCoded.PcdEntry.HelpText 
Table 6 - 192. PcdCoded.PcdEntry.HelpText 


This element specifies the HelpText describing how the module was coded for this 


D ipti 
escription ee 


Required NO 
Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText> This module uses the FixedPcd: 
PcdDxeIp1SwitchToLongMode to compute the top of 
the stack we were allocated, which is used to 
load X64 dxe core. 

Pre-allocate a 32 bytes which conforms to x64 
calling convention. 

Examples The first four parameters to a function are 
passed in rex, rdx, r8 and r9. Any further 
parameters are pushed on the stack. Furthermore, 
space (4 * 8bytes) for the register parameters is 
reserved on the stack, in case the called 
function wants to spill them; this is important 
if the function is variadic. </HelpText> 


6.13.11 PcdCoded.PcdEntry.HelpText:Lang 
Table 6 - 193. PcdCoded.PcdEntry.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 
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6.13.12 PcdCoded.PcdEntry.PcdConsumesRules 


Table 6 - 194. PcdCoded. PcdEntry.PcdConsumesRules 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used to clarify when this this PCD is used by the module. This elementis a 
Boolean expression containing PCDs names, operators, and PPIs, GUIDs, and 
Protocols marked as CONSUMES or SOMETIMES_CONSUMES. This is required 
to be an in-fix logical expression, evaluated left to right, for a range of values, using 
Relational, Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE 
and XOR) that must evaluate to either True or False. To specify a PCD, the form 
PcdTokenSpaceGuidCName.PcdCName must be used. Parentheses are 
recommended for clarity. Ifthe PcdConsumesExpression does not evaluate to true, 
then the value of this PCD will be ignored by the module. 


NO 
Element -— xs:normalizedString 


PCD C names, Protocols, GUIDs, PPIs, true, false and/or Operators: NOT, AND, 
OR, XOR, EQ, LT, LE, GT and GE. 


<PcdConsumesRules> gEfiDevicePathProtocolGuid AND 
(TokenSpaceGuid.PcdCName EQ 4) 
</PcdConsumesRules> 


6.14 ModuleSurfaceArea.PeiDepex 


The following is the description of the ModuleSurfaceArea.PeiDepex instance: 


<PeiDepex 


SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1}> 
<Expression> xs:string </Expression> {1} 


<HelpText 


Lang=""_ xs:language " {0,1} > 
xs:normalizedString 
</HelpText> {0,1} 


</PeiDepex> 


Table 6 - 195. ModuleSurfaceArea. PeiDepex 


Description 


Required 


Data Type 


Data Constraints 


Examples 


This describes the PEIM dependency expression. 
NO 

Element — Complex 

N/A 


N/A 


6.14.1 PeiDepex:SupArchList 
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Table 6 - 196. PeiDepex:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this 
dependency expression. If this attribute is not specified, then this dependency 

Description expression may be used with any CPU Architecture. If this attribute is specified, 
then only those modules that support a subset of the CPU architectures specified 
by this element may use this dependency expression. 


Required NO 


Data Type Attribute - ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList="IA32" 
Examples SupArchList="IA32 X64" 
SupArchList="EBC IPF X64" 


6.14.2 PeiDepex:SupModList 
Table 6 - 197. PeiDepex:ModArchList 


Used by libraries to restrict the set of module types that are allowed to use this 
dependency expression. If this attribute is not specified, then this dependency 

Description expression may be used by any module type. If this attribute is specified, then only 
those modules are in a subset of the module types specified by this element may 
use this dependency expression. 


Required NO 
Data Type Attribute - ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
Data Constraints DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE_ 
DRIVER" 


Examples 


6.14.3 PeiDepex:FeatureFlag 
Table 6 - 198. PeiDepex:FeatureFlag 


Used to restrict the use of this dependency expression. This attribute is a Boolean 


Description expression containing PCD Feature Flag names and operators. This is an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
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Required 


Data Type 
Data Constraints 


Examples 


Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute 

is specified, then this dependency expression may only be used if the Boolean 
expression evaluates to true. 


NO 
Attribute - xs:normalizedString 


PCD C names, true, false and/or Operators: NOT, AND, OR, XOR, EQ, LT, LE, 
GT andGE. 


FeatureFlag="true" 


6.14.4 PeiDepex.Expression 


Table 6 - 199. PeiDepex.Expression 


Description 


Required 
Data Type 


Data Constraints 


Examples 


This is a string contains valid dependency expression, processed left to right. Tools 
may use this data to create a PE] Depex section. The GUID value associated with 
the C name can be found by searching the GUID declarations in the package 
surface area. 


YES 
Element — xs:normalizedString 


A single line that will be used to generate a PEI dependency section. 


gEfiPeiMemoryDiscoveredPpiGuid OR 
gEfiTemporaryRamSupportPpiGuid 


6.14.5 PEIM Dependency Expression Grammar 


The expression must conform to the following grammar. 


Note: Future releases of PI specification may take precedence over this grammar): 


<PeiDepex> 


<bool> 


<term> 


<factor> 


::= | <bool> 


= <bool> AND <term> 
| <bool> OR <term> 
| <term> 

= NOT <factor> 
| <factor> 

= <bool> 

| TRUE 

| FALSE 

| <GUID> 

| END 


- 268 - 


Chapter 6 - Module Surface Area Description 


<GUID> ::= {<RegistryFormatGuid>} {<GuidCName>} 
PeiDepex.HelpText 


6.14.1 PeiDepex.HelpText 
Table 6 - 200. PeiDepex.HelpText 


This element specifies the HelpText describing why this PEI Depex is required for 


D ipti 
a cca the module. 


Required NO 


Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText> This module required the following. 
Examples </ 
HelpText> 


6.14.2 PeiDepex.HelpText:Lang 
Table 6 - 201. PeiDepex.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.15 Module SurfaceArea.DxeDepex 


The following is the description of the ModuleSurfaceArea .DxeDepex instance: 

<DxeDepex 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1}> 
<Expression> xs:string </Expression> {1} 
<HelpText 

Lang="_ xs:language " {0,1} > 
xs :normalizedString 

</HelpText> {0,1} 

</DxeDepex> 


Table 6 - 202. ModuleSurfaceArea.DxeDepex 
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Description 


Required 


Data Type 
Data Constraints 


Examples 


This describes the DXE driver dependency expression. 
NO 

Element — Complex 

N/A 


N/A 


6.15.1 DxeDepex:SupArchList 


Table 6 - 203. DxeDepex:SupArchList 


Description 


Required 
Data Type 


Data Constraints 


Examples 


Used to restrict the set of CPU Architectures that are allowed to use this 
dependency. 


NO 
Attribute — ArchListType 
[A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*)* 


SupArchList="IA32" 
SupArchList="IA32 X64" 
SupArchList="EBC IPF X64" 


6.15.2 DxeDepex:SupModList 


Table 6 - 204. DxeDepex:SupModList 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used by libraries to restrict the set of module types that are allowed to use this 
dependency expression. If this attribute is not specified, then this dependency 
expression may be used by any module type. If this attribute is specified, then only 
those modules are in a subset of the module types specified by this element may 
use this dependency expression. 


NO 
Attribute — ModuleListType 


If specified, must contain one or more of the supported module types separated by 
spaces. The supported module types include BASE, SEC, PEI_ CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 
DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION 
DXE_DRIVER" 
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6.15.3 DxeDepex:FeatureFlag 
Table 6 - 205. DxeDepex:FeatureFlag 


Used to restrict the use of this dependency expression. This attribute is a Boolean 
expression containing PCD Feature Flag names and operators. This is an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
Description must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 
Parentheses are recommended for clarity. If this attribute is specified, then this 
dependency expression may only be used if the Boolean expression evaluates to 
true. 


Required NO 
Data Type Attribute — xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 


Data Constraints and GE. 


Examples FeatureFlag="true" 


6.15.4 DxeDepex.Expression 
Table 6 - 206. DxeDepex.Expression 


This is a string contains valid dependency expression, processed left to right. Tools 
may use this data to create a Dxe Depex section.The GUID value associated with 
the C name can be found by searching the GUID declarations in the package 
surface area. 


Description 


Required YES 
Data Type Element -— xs:normalizedString 


Data Constraints A single line that will be appended to a flag line for the tool code entered. 


gEfiFirmwareVolumeBlockProtocolGuid AND 
Examples gEfiAlternateFvBlockGuid AND 
gEfiFaultTolerantWriteLiteProtocolGuid 


6.15.4.1 DXE Dependency Expression Grammar 


The Expression must conform to the following grammar (note that future releases of PI 
Specification may take precedence over this grammar): 


<DxeDepex> = BEFORE <guid> 
| AFTER <guid> 
| SOR <bool> 
| <bool> 
<bool> = <bool> AND <term> 
| 


<bool> OR <term> 
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<term> 

NOT <factor> 
<factor> 
<bool> 


| 
<term> = 
| 
| TRUE 
| 
| 
| 


<factor> 
FALSE 
GUID 


END 


<guid> {<RegistryFormatGuid>} {<GuidCName>} 


6.15.5 DxeDepex.HelpText 
Table 6 - 207. DxeDepex.HelpText 


This element specifies the HelpText describing why this DXE depex is required for 
the module. 


Description 


Required NO 
Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<HelpText> This module required the following. 


E | 
i cd </HelpText> 


6.15.6 DxeDepex.HelpText:Lang 
Table 6 - 208. DxeDepex.HelpText:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is “en-us.’ 


Examples Lang="en-us” 


6.16 Module SurfaceArea.SmmDepex 


The following is the description of the ModuleSurfaceArea. SmmDepex instance: 
<SmmDepex 
SupArchList=" ArchListType " {0,1} 
SupModList=" ModuleListType " {0,1} 
FeatureFlag=" xs:normalizedString " {0,1}> 
<Expression> xs:string </Expression> {1} 
<HelpText 
Lang="_ xs:language " {0,1} > 
xs :normalizedString 
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</HelpText> {0,1} 
</SmmDepex> 


Table 6 - 209. ModuleSurfaceArea.SmmDepex 


Description This describes the SMM (DXE) driver dependency expression. 


Required NO 
Data Type Element — Complex 
Data Constraints N/A 


Examples N/A 


6.16.1 SmmDepex:SupArchList 
Table 6 - 210. SmmDepex:SupArchList 


Used to restrict the set of CPU Architectures that are allowed to use this 
dependency expression. If this attribute is not specified, then this dependency 

Description expression may be used with any CPU Architecture. If this attribute is specified, 
then only those modules that support a subset of the CPU architectures specified 
by this element may use this dependency expression. 


Required NO 
Data Type Attribute - ArchListType 
Data Constraints [A-Z] [a-zA-Z0-9]* (" " [A-Z] [a-zA-Z0-9]*) * 


SupArchList="IA32" 
Examples SupArchList="IA32 X64" 
SupArchList="EBC IPF X64" 


6.16.2 SmmDepex:SupMod List 
Table 6 - 211. SmmDepex:SupModList 


Used by libraries to restrict the set of module types that are allowed to use this 
dependency expression. If this attribute is not specified, then this dependency 

Description expression may be used by any module type. If this attribute is specified, then only 
those modules are in a subset of the module types specified by this element may 
use this dependency expression. 


Required NO 


Data Type Attribute - ModuleListType 


If specified, must contain one or more of the supported module types separated by 
Data Constraints spaces. The supported module types include BASE, SEC, PEI_CORE, PEIM, 
DXE_CORE, DXE_DRIVER, DXE_RUNTIME DRIVER, DXE_SAL_ 


- 273 - 


Chapter 6 


Examples 


DRIVER, DXE_SMM DRIVER, TOOL, UEFI_DRIVER, UEFI _ 
RUNTIME DRIVER, UEFI_APPLICATION, USER_DEFINED. 


SupModList="BASE" 

SupModList="PEIM DXE_DRIVER" 
SupModList="UEFI_DRIVER UEFI_APPLICATION DXE _ 
DRIVER" 


6.16.3 SmmDepex:FeatureFlag 


Table 6 - 212. SmmDepex:FeatureFlag 


Description 


Required 


Data Type 


Data Constraints 


Examples 


Used to restrict the use of this dependency expression. This attribute is a Boolean 
expression containing PCD Feature Flag names and operators. This is an in-fix 
logical expression, evaluated left to right, for a range of values, using Relational, 
Equality and Logical Operators (NOT, OR, AND, LT, LE, EQ, GT, GE and XOR) that 
must evaluate to either True or False. The form 
PcdTokenSpaceGuidCName.PcdCName is required. 

Parentheses are recommended for clarity. If this attribute is specified, then this 
dependency expression may only be used if the Boolean expression evaluates to 
true. 


NO 
Attribute - xs:normalizedString 


PCD C names, true, false and/or Operators : NOT, AND, OR, XOR, EQ, LT, LE, GT 
and GE. 


FeatureFlag="true" 


6.16.4 SmmDepex.Expression 


Table 6 - 213. SmmDepex.Expression 


Description 


Required 
Data Type 


Data Constraints 


Examples 


This is a string contains valid dependency expression, processed left to right. Tools 
may use this data to create a SMM (Dxe) Depex section. The GUID value 
associated with the C name can be found by searching the GUID declarations in 
the package surface area. 


YES 
Element — xs:normalizedString 


A single line that will be appended to a flag line for the tool code entered. 


gEfiFirmwareVolumeBlockProtocolGuid AND 
gEfiAlternateFvBlockGuid AND 
gEfiFaultTolerantWriteLiteProtocolGuid 


6.16.4.1 SMM Dependency Expression Grammar 


Bes 
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The Expression must conform to the following grammar. 


Note: Future releases of PI specification may take precedence over this grammar): 


<SmmDepex> 


<bool> 


<term> 


<factor> 


<guid> 


= BEFORE <guid> 

| AFTER <guid> 
| SOR <bool> 

| <bool> 

= <bool> AND <term> 
| <bool> OR <term> 
| <term> 

:= NOT <factor> 
| <factor> 

= <bool> 

| TRUE 

| FALSE 

| GUID 

| END 

= {<RegistryFormatGuid>} {<GuidCName>} 


6.16.1 SmmDepex.HelpText 


Table 6 - 214. SmmDepex.HelpText 


Description 


Required 


Data Type 


Data Constraints 


Examples 


This element specifies the HelpText describing why this SMM depex is required for 
the module. 


NO 
Element -— xs:string 
A string that contains one or more lines of text. 


<HelpText> This module required the following. 
</HelpText> 


6.16.2 SmmDepex.HelpText:Lang 


Table 6 - 215. SmmDepex.HelpText:Lang 


Description 
Required 


Data Type 


Data Constraints 


Examples 


The language code uses an RFC 1766 language code identifier 
NO 
Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 
not specified, the default is “en-us.’ 


Lang="en-us” 
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6.17 ModuleSurfaceArea.MiscellaneousFiles 


The following is the description of the ModuleSurfaceArea .MiscellaneousFiles 
instance: 
<MiscellaneousFiles> 
<Description 
Lang=""xs:language " {0,1} 
xs:string 
</Description> {0,} 
<Filename 
Executable=" xs:boolean " {0,1} 
xs: anyURI 
</Filename> {1,} 
</MiscellaneousFiles> 


Table 6 - 216. ModuleSurfaceArea. MiscellaneousFiles 


This element contains any module specific miscellaneous files not defined 


Description ; 
previously. 


Required NO 


Data Type Element — Complex 


Data Constraints Free-form text or any well formed XML element(s.) 


Examples N/A 


6.17.1 MiscellaneousFiles.Description 
Table 6 - 217. MiscellaneousFiles.Description 


Description Any information that might be appropriate for files listed in this section. 
Required NO 

Data Type Element -— xs:string 

Data Constraints A string that contains one or more lines of text. 


<Description> Readme.txt is a quick start guide 


Examples 
for using this module. </Description> 


6.17.2 MiscellaneousFiles. Description:Lang 


Table 6 - 218. MiscellaneousFiles. Description:Lang 


Description 


Required 


Data Type 


The language code uses an RFC 1766 language code identifier 
NO 


Element — xs:language 
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If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints 
not specified, the default is "en-us.' 


Examples Lang="en-us" 


6.17.3 MiscellaneousFiles.Filename 
Table 6 - 219. MiscellaneousFiles.Filename 


A file that is included in the distribution package that does not pertain to any of the 


Description 
: previously defined sections. 


Required NO 


Data Type Element — xs:anyURI 


The path and filename of the file, relative to the Module’s “root” directory (as 


Data Constraints 
specified in theDistribution Content File.) 


<File>FooBarMfgBuildReadMe. txt</File> 


Examples <File> Specs/FooBar_ Rules.pdf </File> 


6.17.4 Misc.Filename:Executable 
Table 6 - 220. Misc.Filename:Executable 


Description This flag is used during installation to ensure that the file is executable. 
Required NO 
Data Type Attribute — xs:boolean 


Data Constraints “true’ or “false” (default) 


Examples Executable=”true” 


6.18 ModuleSurfaceArea.UserExtensions 


The following is the description of the ModuleSurfaceArea.UserExtensions instance: 
<UserExtensions 
UserId=" xs:NCName " {1} 
Identifier="_xs:string " {1} 
AnyAttribute {0,} > 
Mixed Content, any user defined elements are also permitted. 
Any Text or XML Format 
</UserExtensions> 


Table 6 - 221. ModuleSurfaceArea.UserExtensions 


Description This section is used for any processing instructions that may be custom to the 
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Required 
Data Type 
Data Constraints 


Examples 


content provided by the distribution that are common to module. 

The content is vendor specific. 

The content can be plain text as well as any user-defined, properly formatted XML 
structure 


NO 
Element — Complex 
None 


N/A 


6.18.1 UserExtensions:Userld 


Table 6 - 222. UserExtensions:Userld 


Description 
Required 


Data Type 


Data Constraints 


Examples 


The normative reference name to identify the originator of this information. 
YES 
Attribute — xs:NCName 


A string that starts with a letter followed by any combination of letters, digits, 
underscores, and periods. No whitespace characters are allowed. 


Name="NoSuchCorp” 
Name=”" FooBarMfg” 


6.18.2 UserExtensions:!dentifier 


Table 6 - 223. UserExtensions:Identifier 


Description 
Required 


Data Type 


Data Constraints 


Examples 


The string reference identify this information. 
YES 
Attribute— xs:normalizedString 


A string that starts with a number or a letter followed by any combination of letters, 
digits, underscores, dashes and periods. Whitespace characters are allowed. 


Name="Special Build Rules 1" 
Name="£6665cf£5-8290-4b02-ba0c-5cb5a9542176" 


- 278 - 


Chapter 7 - Tools Surface Area Description 


Chapter 7 - 
Tools Surface Area Description 


This section is used for distributing various documentation, configuration templates and tools. 


The XML Instance Representation for DistributionPackage. Tools is as follows: 


<Tools> 
<Header> ... </Header> {0,1} 
<Filename> ... </Filename> {1,} 
</Tools> 


Table 7 - 1. DistributionPackage. Tools 


os This element contains all the information associated with a Tools Surface Area 
Description ae 
Description 
Required NO 
Data Type Element — Complex 


Data Constraints The Header element is required. All other elements are optional. 


Examples N/A 


7.1 Tools.Header 


The following is the description of the Tools .Header instance: 
<Header> 
<Name> xs:normalizedString </Name> {1} 
<Copyright> xs:string </Copyright> {0,1} 
<License> xs:string </License> {0,1} 
<Abstract> 
Lang=""_xs:language " {0,1} > 
xs:normalizedString </Abstract> {0,} 
<Description 
Lang=""_xs:language " {0,1} > 
xs:string </Description> {0,} 
</Header> 


Table 7 - 2. Tools. Header 


This element contains the header information for a Tools Surface Area Description. 
This includes the name of the tools package, descriptions of the tools package, 
copyright and licensing information associated with the tools package, and the 
version of XML Schema to which this file conforms. 


Description 


Required NO 
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Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 


7.1.1 Header.Name 
Table 7 - 3. Header.Name 


Description The User Interface Name for the Tools package. 
Required YES 

Data Type Element -— xs:normalizedString 

Data Constraints String value of one or more characters. 


<Name>BaseTools Package, Version 2.0</Name> 


E I i 
capes <Name>AntTools Package, Version 1.2</Name> 


7.1.2 Header.Copyright 
Table 7 - 4. Header.Copyright 


The copyright for this tools package if it is different than the copyright of the 
distribution package. The copyright is generated by the creator of a package. Ifa 

Description derivative work is generated from an existing package, then the existing copyright 
must be maintained, and additional copyrights may be appended to the end of this 
element. 


Required NO 
Data Type Element — xs:string 
Data Constraints A set of one or more copyright statements on one or more lines of text. 


<Copyright> Copyright (c) 2008, Nosuch 


E I 
ee Corporation. All rights reserved. </Copyright> 


7.1.3 Header.License 
Table 7 - 5. Header.License 


A license that describes any restrictions on the use of this tools package. Ifa 
derivative work is allowed by the original license and a derivative work is 
generated from an existing package, then the existing license must be maintained, 
and additional licenses may be appended to the end of this element. 


Description 


Required NO 
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Data Type Element — xs:string 


Data Constraints A string that contains one or more lines of text. 


<License> 

This program and the accompanying materials are 
licensed and made available under the terms and 
conditions of the BSD License which accompanies 


this distribution. The full text of the license 
may be found at 
Examples http: //opensource.org/licenses/bsd-license. php 


THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE 
ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR 
REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR 
IMPLIED. 
</License> 


7.1.4 Header.Abstract 
Table 7 - 6. Header.Abstract 


Description A one line description of the tools. 
Required NO 

Data Type Element — xs:normalizedString 

Data Constraints String value of one or more characters. 


<Abstract> Win32 Binaries and template files for 


E I 
ci a Makefile Base Build system </Abstract> 


7.1.4.1 Header.Abstract:Lang 
Table 7 - 7. Header.Abstract:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints : 
not specified, the default is “en-us.’ 


Lang="en-us” 
Lang="fra” 


Examples 
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7.1.5 Header.Description 
Table 7 - 8. Header.Description 


A complete description of a tools package. This description should include the 
release name of the package, the version of the package, and a complete 
description of the package contents and/or features including a description of the 
updates since the previous package release. 


Description 


Required NO 


Data Type Element — xs:string 


Data Constraints A string that contains one or more lines of text. 


<Description> 

BaseTools package using Makefile based builds. 
The binaries provided are Win32 executables, 
which can execute on both IA32 and X64 based 
operating systems. UNIX based operating systems 
will need to compile the C tools which are POSIX 
compliant. Python tools may be compiled to 
executable format, or run under the Python 
interpreter. 

</Description> 


Examples 


7.1.5.1 Header.Description:Lang 
Table 7 - 9. Header.Description:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints : : 
not specified, the default is “en-us.’ 


Lang="en-us” 
Lang="fra” 


Examples 


7.2 Tools.Filename 


This section is used for distributing both source and binary files for tools. If the Exec bit is not set, 
then the file is either a source file, a configuration file, or written documentation. 
The following is the description of the Tools. Filename instance: 
<Filename 
OS=" SupportedOs " {0,1} 
Executable=" xs:boolean " {0,1} > 
xs:anyURI 
</Filename> {1,} 
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Table 7 - 10. Tools. Filename 


Any description, executable, template or configuration file that make up the 


Description 
infrastructure and build system. 


Required YES 


Data Type Element — xs:anyURI 


Data Constraints The path and filename of the file as it appears in the Distribution Content FileFile. 


<Filename Root="true”>BuildNotes2.txt</Filename> 

<Filename>Conf/tools def.template</Filename> 
Examples <Filename Root="true”>edksetup.bat</Filename> 

<Filename 

Revision=" 937”>Bin/Win32/build.exe</Filename> 


7.2.1 Filename:O0S 
Table 7 - 11. Filename:0S 


er Used to identify a specific operating system this tool is targeted for. This is 
Description . : 
informational only. 
Required NO 
Data Type Attribute — xs:NCName 


Enumeration: Win32, Win64, Linux32, Linux64, OS/X32,0S/xX64, 


Data Constraints : : : ‘ . ' . 
GenericWin, GenericNix or any single word identifier. 


Examples OS="Win32” 


7.2.2 Filename:Executable 
Table 7 - 12. Filename:Executable 


Description This flag is used during installation to ensure that the file is executable. 
Required NO 
Data Type Attribute — xs:boolean 


Data Constraints “true’ or “false?” (default — not present) 


Examples Executable=”true” 
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Chapter 8 - 
MiscellaneousFiles Section 


This section describes the miscellaneous files section of the Distribution Description. These 
sections are used to list files that do not fall into previous categories. The distribution package 
provider must provide information as to how this information will be used. 


The XML Instance Representation for DistributionPackage.MiscellaneousFiles is 
as follows: 


<MiscellaneousFiles 
<Header> ... </Header> {0,1} 
<Filename> ... </Filename> {0,} 
</MiscellaneousFiles> 


Table 8 - 1. DistributionPackage.MiscellaneousFiles 


This element contains any miscellaneous distribution information and/or files not 
defined previously. Processing of this section is specified as “lax”. 


Description 


Required NO 
Data Type Element — Complex 
Data Constraints Free-form text or any well formed XML element(s.) 


Examples N/A 


8.1 MiscellaneousFiles.Header 


The following is the description of the MiscellaneousFiles.Header instance: 
<Header> 
<Name> xs:normalizedString </Name> {0,1} 
<Copyright> xs:string </Copyright> {0,1} 
<License> xs:string </License> {0,1} 
<Abstract> xs:normalizedString </Abstract> {0,1} 
<Description> xs:string </Description> {0,1} 
</Header> 


Table 8 - 2. MiscellaneousFiles.Header 


Description This element contains the header information for a Misc Section. 
Required NO 
Data Type Element — Complex 


Data Constraints N/A 


Examples N/A 
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8.1.1 Header.Name 


Table 8 - 3. Header.Name 


Description 


Required 


Data Type 


Data Constraints 


Examples 


The User Interface Name for the Miscellaneous content. 
NO 

Element -— xs:normalizedString 

String value of one or more characters. 


<Name>BaseTools Package, Version 2.0</Name> 
<Name>AntTools Package, Version 1.2</Name> 


8.1.2 Header.Copyright 


Table 8 - 4. Header.Copyright 


Description 


Required 
Data Type 


Data Constraints 


Examples 


The copyright for this miscellaneous content if itis different than the copyright of the 
distribution package. The copyright is generated by the creator of the content. Ifa 
derivative work is generated from an existing work, then the existing copyright must 
be maintained, and additional copyrights may be appended to the end of this 
element. 


NO 
Element -— xs:string 
A set of one or more copyright statements on one or more lines of text. 


<Copyright> 

Copyright (c) 2008, Nosuch Corporation. All 
rights reserved. 

</Copyright> 


8.1.3 Header.License 


Table 8 - 5. Header.License 


Description 


Required 


Data Type 
Data Constraints 


Examples 


A license that describes any restrictions on the use of this content. If a derivative 
work is allowed by the original license and a derivative work is generated from an 
existing package, then the existing license must be maintained, and additional 
licenses may be appended to the end of this element. 


NO 
Element -— xs:string 
A string that contains one or more lines of text. 


<License> 
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This program and the accompanying materials are 
licensed and made available under the terms and 
conditions of the BSD License which accompanies 
this distribution. The full text of the license 
may be found at 


http: //opensource.org/licenses/bsd-license.php 


THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE 
ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR 
REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR 
IMPLIED. 
</License> 


8.1.4 Header.Abstract 
Table 8 - 6. Header.Abstract 


Description A brief text description of the content. 
Required NO 

Data Type Element -— xs:normalizedString 

Data Constraints A string that contains two or more words. 


Examples <Abstract> Applicable Specifications </Abstract> 


8.1.4.1 Header.Abstract:Lang 
Table 8 - 7. Header.Abstract:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Data Constraints : 
not specified, the default is “en-us.’ 


Lang="en-us” 
Lang="fra” 


Examples 


8.1.5 Header.Description 


Table 8 - 8. Header.Description 
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Description A complete description of the content. 


Required NO 


Data Type Element — xs:string 
Data Constraints A string that contains one or more lines of text. 


<Description> Specification PDF documents ACPI 


popes WG. Dated 2004. </Description> 


8.1.5.1 Header.Description:Lang 
Table 8 - 9. Header.Description:Lang 


Description The language code uses an RFC 1766 language code identifier 
Required NO 
Data Type Attribute — xs:language 


If present, the language code must use an RFC 1766 language code identifier. If 


Dat traint 
aie Cons tallits not specified, the default is “en-us.’ 


Lang="en-us” 


E | 
phew Lang="fra” 


8.2 MiscellaneousFiles.Filename 


The following is the description of the MiscellaneousFiles. Filename instance: 
<Filename 
Executable="_ xs:boolean " {0,1} > 
xs:anyURI 
</Filename> 


Table 8 - 10. MiscellaneousFiles.Filename 


eScaMion A file that is included in the distribution package that does not pertain to any of the 
P previously defined sections. 

Required NO 

Data Type Element -— xs:anyURI 


Data Constraints The path and filename of the file as it appears in the Distribution Content File. 


Examples <File>FooBarMfgBuildReadMe. txt</File> 


8.2.1 Filename:Executable 


Table 8 - 11. Filename:Executable 
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Description 
Required 
Data Type 


Data Constraints 


Examples 
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This flag is used during installation to ensure that the file is executable. 
NO 


Attribute — xs:boolean 


“true’ or “false” (default) 


Executable=” true” 
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Chapter 9 - 
UserExtensions 


This section describes the UserExtensions section of the Distribution Description File. These 
sections are used to describe any extensions to this specification. The distribution package 
provider must provide information as to how this information will be used. 


The following is a description of the DistributionPackage.UserExtensions instance: 


<UserExtensions 
UserId="_ xs:NCName " {1} > 
Identifier="_xs:string " {0,1} 
AnyAttribute {0,} > 
mixed="true" 
Any Content is permitted 
</UserExtensions> 


Table 9 - 1. DistributionPackage.UserExtensions 


This element contains any miscellaneous distribution information not defined 
previously. Processing of this section is specified as “lax”. 


Description 


Required NO 
Data Type Element — Complex, mixed=true 
Data Constraints None 


Examples N/A 


9.1 UserExtensions:Userld 


Table 9 - 2. UserExtensions:Userld 


Description The normative reference name to identify the originator of this information. 
Required Yes 
Data Type Attribute— xs:NCName 


Data Constraints A single word identifier for grouping similar content. 


Examples UserId="NoSuchCorp” 


9.2 UserExtensions:Identifier 


Table 9 - 3. UserExtensions:Identifier 
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Description A single string that can be used to sub-divide content of a group of items. 
Required NO 
Data Type Attribute— xs:string 


Data Constraints A string identifier for sub-grouping content. 


Identifier=”"PRE_ BUILD” 
Identifier="f£6665cf£5-8290-4b02-ba0c-5cb5a9542176" 


Examples 
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Appendix A - 
XML Examples 


This section contains several XML examples. These examples are either portions of a 
distribution package or simple examples of a distribution package containing a single 
component. Typical use cases will likely be more complex than shown in this appendix 
because distribution packages will likely contain several components of each type. The 
following XML example are included in this section: 


¢ Distribution Package Header 

¢ Package Header 

¢ Distribution Package containing source to a UEFI Application 
¢ Distribution Package containing binary for a UEFI Drivers 

¢ Distribution Package containing source for a Library 

¢ Distribution Package containing source for a PI PEIM 

¢ Distribution Package containing source for a DXE Driver 


¢ Distribution Package containing a binary of a Tool 


A.1 Distribution Package Header 


The following example is the header from a distribution package for chipset related 
content. This distribution package is read-only and consumers of this package are not 
allowed to repackage this content into another package. This distribution package is from 
Nosuch Corporation, and contains the base data types and libraries for implementing 
chipset modules for Si products produced by Nosuch Corporation. The version of the 
release is 1.2 and it was created on 3/24/2008 at 09:30. It is covered by a BSD license and 
the Nosuch Corporation owns the copyright for the content. 
<DistributionHeader ReadOnly="true" RePackage="false"> 
<Name BaseName="NosuchChipset">Nosuch Chipset</Name> 
<GUID Version="1.2"> AFODDA2E-EA83-480b-B2CE-FCOBB2F894C2 
</GUID> 
<Vendor> Nosuch Corporation </Vendor> 
<Date>2008-03-24T09:30:00</Date> 
<Copyright>Copyright (c) 2008, Nosuch Corporation. All rights 
reserved.</Copyright> 
<License> 
This program and the accompanying materials are licensed and 
made available under 
the terms and conditions of the BSD License which 
accompanies this distribution. 
The full text of the license may be found at: 
http: //opensource.org/licenses/bsd-license.php 
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS 
IS" BASIS, WITHOUT 
WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR 
IMPLIED. 
</License> 
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<Abstract> Version 1.2 of the NoSuchChipset Distribution Package. 
</Abstract> 
<Description> 
Initial release of the NoSuchChipset, Version 1.0 providing the 
base data types 
and libraries for NoSuch UEFI Driver. This includes special 
libraries for 
reporting status codes of the driver. 
</Description> 
<Signature> 09fa8fc7222da9afd9ffd52ba8b73£45 </Signature> 
<XmlSpecification> 1.0 </XmlSpecification> 
</DistributionHeader> 


A.2 Package Header 


The following example is the package surface area for the UEFI or PI Packages that provide the 
base types and defintions from the UEFI 2.2 Specification and PI 1.2 Specification. It is 
implemented by Nosuch Corporation, covered by a copyright from Nosuch Corporation, and 
licensed under BSD. This abbreviated example shows the public include files Uefi .h, 
PiPeim.h, and PiDxe.h along with the GuidValue for EFI global variables, the Protocol 
GUID for the EFI Block I/O Protocol that is only available to a subset of the DXE and UEFI 
module types, and a token space GUID for Platform Configuration Database (PCD) tokens defined 
by Nosuch Corporation. It also declares an I/O Port Library class and a PCD that are not related to 
the UEFI or PI Specification content, but are listed here because they are referenced by additional 
examples later in this section. 
<PackageSurfaceArea> 
<Header> 
<Name BaseName="UefiPiPkg"> UEFI/PI Package </Name> 
<GUID Version="1.0"> 26E136A4-1060-48fb-AEB6-3DB66C175CFB </GUID> 
<Copyright> 
Copyright (c) 2008, Nosuch Corporation. All rights reserved. 
</Copyright> 
<License> 
This program and the accompanying materials are licensed and 
made available 
under the terms and conditions of the BSD License which 
accompanies this 
distribution. The full text of the license may be found at: 
http: //opensource.org/licenses/bsd-license.php 
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" 
BASIS, WITHOUT 
WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR 
IMPLIED. 
</License> 
<Abstract> Version 1.0 of the UEFI/PI Package. </Abstract> 
<Description> 
Provides the base data types and definitions from the UEFI 2.2 
Specification 
and the PI 1.2 Specification 
</Description> 
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<PackagePath> UefiPiPkg </PackagePath> 
</Header> 
<LibraryClassDeclarations> 
<LibraryClass Keyword="IoPortLib"> 
<HeaderFile> Include/Library/IoPortLib.h </HeaderFile> 
</LibraryClass> 
</LibraryClassDeclarations> 
<PackageIncludes> 
<PackageHeader> 
<HeaderFile> Include/Uefi.h </HeaderFile> 
</PackageHeader> 
<PackageHeader> 
<HeaderFile> Include/PiPeim.h </HeaderFile> 
</PackageHeader> 
<PackageHeader> 
<HeaderFile> Include/PiDxe.h </HeaderFile> 
</PackageHeader> 
</PackageIncludes> 
<GuidDeclarations> 
<Entry UiName="EFI Global Variable GUID" 
GuidTypes="Variable"> 
<CName> gEfiGlobalVariableGuid </CName> 
<GuidValue> 8BE4DF61-93CA-11D2-AA0D-00E098032B8C 
</GuidValue> 
</Entry> 
<Entry UiName="Toke Space GUID for Nosuch Corp PCDs" 
GuidTypes="TokenSpaceGuid"> 
<CName> gNosuchCorpTokenSpaceGuid </CName> 
<GuidValue> 5702D1FD-AD66-4c14-980F-DF9F34113B81 
</GuidValue> 
</Entry> 
</GuidDeclarations> 
<ProtocolDeclarations> 
<Entry UiName="Block I/O Protocol" SupModuleList="DXE_ DRIVER 
DXE_RUNTIME DRIVER UEFI_DRIVER UEFI_APPLICATION"> 
<CName> gEfiBlockIoProtocolGuid </CName> 
<GuidValue> 964E5B21-6459-11D2-8E39-00A0C969723B 
</GuidValue> 
<HelpText> 
The Block I/O Protocol provides services to read, write, 
and flush block to a 
block oriented storage device such as a hard disk, CD- 
ROM, DVD, and floppy. 
This Protocol is available to all CPU types, but is 
restricted for use by 
DXE_DRIVER, UEFI_RUNTIME DRIVER, UEFI_DRIVER, and UEFI_ 
APPLICATION module 
types. 
</HelpText> 
</Entry> 
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</ProtocolDeclarations> 
<PcdDeclarations> 
<PcdEntry> 
<TokenSpaceGuidCname> gNosuchCorpTokenSpaceGuid 
</TokenSpaceGuidCname> 
<Token> 00000001 </Token> 
<CName> SmBusHostControllerIoPortBaseAddress </CName> 
<DatumType> UINT32 </DatumType> {1} 
<ValidUsage> FixedPcd PatchPcd Pcd PcdEx </ValidUsage> 
<DefaultValue> 0x500 </DefaultValue> 
</PcdEntry> 
</PcdDeclarations> 
</PackageSurfaceArea> 


A.3 UEFI Application 


The following example is the distribution package that contains a package, and that package 
contains the source code to a module that is an EFI Application that displays the message “Hello 
World” on the console output devices. All of the material in this distribution package are 
implemented by Nosuch Corporation, covered by a copyright from Nosuch Corporation, and 
licensed under BSD. The EFI application depends on the UefiPkg described in Section A.2 so the 
application can use Uefi.h that contains the base types and defintions from the UEFI 2.2 
Specification. 
<?xml version="1.0"?> 
<DistributionPackage xmlns="http://www.uefi.org/2012/1.0" 
xmlns:xsi="http: /www.w3.org/2001/XMLSchema-instance" > 
<DistributionHeader ReadOnly="true" RePackage="false"> 
<Name BaseName="HelloWorldDistribuition">Hello World 
Distribution</Name> 
<GUID Version="1.0"> 62D1DDD0-FC9C-4809-BE6D-DFB8B463B1D6 </GUID> 
<Vendor> Nosuch Corporation </Vendor> 
<Date>2008-03-24T09:30:00</Date> 


<Copyright> 
Copyright (c) 2008, Nosuch Corporation. All rights reserved. 
</Copyright> 
<Abstract> Version 1.0 of the Hello World Distribution Package. 
</Abstract> 


<Xml1Specification> 1.0 </XmlSpecification> 
</DistributionHeader> 
<PackageSurfaceArea> 
<Header> 
<Name BaseName="HelloWorldPkg"> Hello World Package </Name> 
<GUID Version="1.0"> 0410A3C9-6875-4010-8EC1-OBC1FD96D9AC 
</GUID> 
<Copyright> 
Copyright (c) 2008, Nosuch Corporation. All rights reserved. 
</Copyright> 
<Abstract> Version 1.0 of the Hello World Package. </Abstract> 
<PackagePath> HelloWorldPkg </PackagePath> 
</Header> 
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<ModuleSurfaceArea BinaryModule="false"> 
<Header> 
<Name BaseName="HelloWorld"> Hello World </Name> 
<GUID Version="1.0"> 179F65BD-0092-455b-81A5- 
09B1CD27EA33 </GUID> 
<Copyright> 
Copyright (c) 2008, Nosuch Corporation. All rights 
reserved. 
</Copyright> 
<Abstract> Hello World UEFI Application </Abstract> 
<Description> 
Displays the message ‘Hello World’ on all UEFI 
console output devices 
</Description> 
</Header> 
<ModuleProperties> 
<ModuleType> UEFI_APPLICATION </ModuleType> 
<Path> HelloWorld </Path> 
<UefiSpecificationVersion> 2.0 
</UefiSpecificationVersion> 
</ModuleProperties> 
<SourceFiles> 
<Filename> HelloWorld.c </Filename> 
</SourceFiles> 
<PackageDependencies> 
<Package> 
<GUID Version="1.0"> 26E136A4-1060-48fb-AEB6- 
3DB66C175CFB</GUID> 
</Package> 
</PackageDependencies> 
<Externs> 
<Extern> 
<EntryPoint> InitializeHelloWorld </EntryPoint> 
</Extern> 
</Externs> 
</ModuleSurfaceArea> 
</PackageSurfaceArea> 
</DistributionPackage> 


A.4 UEFI Application Source Files 


#include <Uefi.h> 


EFI_STATUS 

EFIAPI 

InitializeHelloWorld ( 
IN EFI_HANDLE ImageHandle, 
IN EFI_SYSTEM TABLE *SystemTable 
) 
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SystemTable->ConOut->OutputString (SystemTable->ConOut, L”Hello 


World\n”) ; 
return EFI_ SUCCESS; 
} 


A.5 UEFI Driver 


This examples contains the Module Surface Area for a UEFI Driver binary for a PCI graphics 
controller from Nosuch Corporation. Binary images for [A32, X64, IPF, and EBC are included. 
The driver follows the UEFI Driver Model and produces the EFI Driver Bindng Protocol. This 
driver uses the services of the EFI PCI I/O Protocol to produce the Graphics Ouput Protocol 


services. 


<ModuleSurfaceArea BinaryModule="true"> 


<Header> 


<Name BaseName="NosuchUefiGop"> Nosuch UEFI GOP Driver </Name> 
<GUID Version="1.0"> F32C4FAC-F5E9-4cdc-B8C9-48AC276CB87F 


</GUID> 
<Copyright> 


Copyright (c) 2008, Nosuch Corporation. All rights reserved. 


</Copyright> 


<Abstract> UEFI Graphics Output Protocol driver </Abstract> 


<Description> 


Produces the Graphics Output Protocol for PCI graphics 


controllers from 
Nosuch Corporation 
</Description> 
</Header> 
<ModuleProperties> 


<ModuleType> UEFI_DRIVER </ModuleType> 


<Path> NosuchUefiGop </Path> 


<UefiSpecificationVersion> 2.0 </UefiSpecificationVersion> 


</ModuleProperties> 
<BinaryFiles> 
<BinaryFile> 
<Filename FileType="PE32" 
Ia32/NosuchUefiGop.efi 
</Filename> 
<Filename FileType="PE32" 
X64/NosuchUefiGop.efi 
</Filename> 
<Filename FileType="PE32" 
Ipf/NosuchUefiGop.efi 
</Filename> 
<Filename FileType="PE32" 
Ebc/NosuchUefiGop.efi 
</Filename> 
</BinaryFile> 
</BinaryFiles> 
<Protocols> 


SupArchList="IA32"> 


SupArchList="X64"> 


SupArchList="IPF"> 


SupArchList="EBC"> 
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<Protocol Usage="PRODUCES"> 
<CName> gEfiDriverBindingProtocolGuid </CName> 
</Protocol> 
<Protocol Usage="TO_ START"> 
<CName> gEfiPcilIoProtocolGuid </CName> 
</Protocol> 
<Protocol Usage="BY_START"> 
<CName> gEfiGraphicsOutputProtocolGuid </CName> 
</Protocol> 
</Protocols> 
</ModuleSurfaceArea> 


A.6 Library 


This example contains the Module Surface Area for the source code to a library from 
Nosuch Corpration that produces the a set APIs to access I/O ports on IA32 and X64 
platforms. On IA32 and X64 platforms, this is implemented using IN and OUT 
instructions. In this implementation assembly code is required to perform IN and OUT 
instructions. Both the MSFT and GCC versions of the ASM code for both IA32 and X64 
are provided so this library can be built using a number of different tool chains. 
<ModuleSurfaceArea BinaryModule="false"> 
<Header> 
<Name BaseName="IoPortLib"> 
I/O Port Library 
</Name> 
<GUID Version="1.0"> E9491CAD-9457-4fac-A856- 
87EC9DB60A23 </GUID> 
<Copyright> 
Copyright (c) 2008, Nosuch Corporation. All rights 
reserved. 
</Copyright> 
<Abstract> 
This library provides APIs to access I/O ports on IA32 
and X64 platforms. 
</Abstract> 
</Header> 
<ModuleProperties SupArchList="IA32 X64"> 
<ModuleType> BASE </ModuleType> 
<Path> IoPortLib </Path> 
</ModuleProperties> 
<LibraryClassDefinitions> 
<LibraryClass Usage="PRODUCES" > 
<Keyword> IoPortLib </Keyword> 
</LibraryClass> 
</LibraryClassDefinitions> 
<SourceFiles> 
<Filename> IoPortLib.c </Filename> 
<Filename Family="MSFT" SupArchList="IA32"> 
Ia32/InOut.asm </Filename> 
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<Filename Family="MSFT" SupArchList="X64"> X64/InOut.asm 
</Filename> 
<Filename Family="GCC" SupArchList="IA32"> Ia32/InOut.s 
</Filename> 
<Filename Family="GCC" SupArchList="X64"> X64/InOut.sS 
</Filename> 
</SourceFiles> 
<PackageDependencies> 
<Package> 
<GUID Version="1.0"> 26E136A4-1060-48fb-AEB6- 
3DB66C175CFB</GUID> 
</Package> 
</PackageDependencies> 
<PPIs> 
<Ppi Usage="PRODUCES"> 
<CName> gEfiPciCfg2PpiGuid </CName> 
</Ppi> 
</PPIs> 
<Externs> 
<Extern> 
<EntryPoint> PeimInitializePciCfg2 </EntryPoint> 
</Extern> 
</Externs> 
</ModuleSurfaceArea> 


A.7 PI PEIM 


This examples contains the Module Surface Area for the sources to a PEIM that is implemented 
by Nosuch Corporation and produces the PEI CFG2 PPI using the 0xCF8 and 0xCFC I/O ports to 
generate PCI configuration cycles. The dependency expression for this PEIM is TRUE. This 
PEIM uses an I/O Port Library to access the OxCF8 and OxCFC I/O ports, and has a module entry 
point called PeimInitializePciCfg2. 
<ModuleSurfaceArea BinaryModule="false"> 
<Header> 
<Name BaseName="PciCfg2Pei"> 
PCI Configuration2 PEIM 
</Name> 
<GUID Version="1.0"> EA3AA39C-2AC1-44ef-8D2D-D57E34C9FDAC 
</GUID> 
<Copyright> 
Copyright (c) 2008, Nosuch Corporation. All rights reserved. 
</Copyright> 
<Abstract> 
Produces the PCI CFG2 PPI using I/O ports OxCF8 and 0xCFC to 


perform 
PCI configuration cycles. 
</Abstract> 
</Header> 
<ModuleProperties> 
<ModuleType> PEIM </ModuleType> 
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<Path> PciCfg2Pei </Path> 
<PiSpecificationVersion> 1.0 </PiSpecificationVersion> 
</ModuleProperties> 
<LibraryClassDefinitions> 
<LibraryClass Usage="CONSUMES" > 
<Keyword> IoPortLib </Keyword> 
</LibraryClass> 
</LibraryClassDefinitions> 
<SourceFiles> 
<Filename> PciCfg2.c </Filename> 
</SourceFiles> 
<PackageDependencies> 
<Package> 
<GUID Version="1.0"> 26E136A4-1060-48fb-AEB6- 
3DB66C175CFB</GUID> 
</Package> 
</PackageDependencies> 
<PPIs> 
<Ppi Usage="PRODUCES"> 
<CName> gEfiPciCfg2PpiGuid </CName> 
</Ppi> 
</PPIs> 
<Externs> 
<Extern> 
<EntryPoint> PeimInitializePciCfg2 </EntryPoint> 
</Extern> 
</Externs> 
<PeiDepex> 
<Expression> TRUE </Expression> 
</PeiDepex> 
</ModuleSurfaceArea> 


A.8 Pl DXE Driver 


This examples contains the Module Surface Area for the sources to a DXE Driver that is 
implemented by Nosuch Corporation and produces the SMBUS Host Controller Protrocol 
using I/O ports to access the SMBUS host controller hardware. The dependency 
expression for this DXE Driver is the Metronome Architectural Protocol because some of 
the SMBUS Host Controller Protocol services require a timeout. This DXE Driver uses 
the I/O Port Library to access the I/O ports for the SMBUS host controller, and the base 
I/O port address for the SMBUS Host Controller is defined by a the Platform 
Configuration Database token called 
SmBusHostControllerIoPortBaseAddress. The entry point to this module is 
called InitializeSmBusHostController. 
<ModuleSurfaceArea BinaryModule="false"> 
<Header> 
<Name BaseName="SmBusHostControllerDxe "> 
SMBUS Host Controller DXE Driver 
</Name> 
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<GUID Version="1.0"> EF514376-72C0-43e3-B4C7-2AE8D4D0848A 
</GUID> 
<Copyright> 
Copyright (c) 2008, Nosuch Corporation. All rights reserved. 
</Copyright> 
<Abstract> 
Produces the SMBUS Host Controller Protocol in the Nosuch 
Corporation 
chipset. The SMBUS controller in this chipset is access 
through I/O 
ports whose I/O port base address is programmable. The I/O 
port base 
is specified by the Platform Configuration Database token 
SmBusHostControllerIoPortBaseAddress. 
</Abstract> 
</Header> 
<ModuleProperties> 
<ModuleType> DXE_DRIVER </ModuleType> 
<Path> SmBusHostControllerDxe </Path> 
<PiSpecificationVersion> 1.0 </PiSpecificationVersion> 
</ModuleProperties> 
<LibraryClassDefinitions> 
<LibraryClass Usage="CONSUMES" > 
<Keyword> IoPortLib </Keyword> 
</LibraryClass> 
</LibraryClassDefinitions> 
<SourceFiles> 
<Filename> SmBusHostController.c </Filename> 
</SourceFiles> 
<PackageDependencies> 
<Package> 
<GUID Version="1.0"> 26E136A4-1060-48fb-AEB6- 
3DB66C175CFB</GUID> 
</Package> 
</PackageDependencies> 
<Protocols> 
<Protocol Usage="PRODUCES"> 
<CName> gEfiSmbusHostControllerProtocolGuid </CName> 
</Protocol> 
<Protocol Usage="CONSUMES"> 
<CName> gEfiMetronomeArchProtocolGuid </CName> 
</Protocol> 
</Protocols> 
<Externs> 
<Extern> 
<EntryPoint> InitializeSmBusHostController </EntryPoint> 
</Extern> 
</Externs> 
<PcdCoded> 
<PcdEntry PcdItemType="Pcd" PcdUsage="CONSUMES"> 
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<CName> SmBusHostControllerIoPortBaseAddress </CName> 
<TokenSpaceGuidCName> gNosuchCorpTokenSpaceGuid 
</TokenSpaceGuidCName> 
</PcdEntry> 
</PcdCoded> 
<DxeDepex> 
<Expression> gEfiMetronomeArchProtocolGuid </Expression> 
</DxeDepex> 
</ModuleSurfaceArea> 


A.9 Tool 


This examples contains an executable utility from Nosuch Corporation that help print 
UEFI source files. Two versions of the tool are included. One for Win32 and the other for 
Winé4. 
<Tools> 
<Header> 
<Name> UEFI Print Utility Version 1.0 </Name> 
<Copyright> 
Copyright (c) 2008, Nosuch Corporation. All rights 
reserved. 
</Copyright> 
<Abstract> Utility to print UEFI source files </Abstract> 
</Header> 
<Filename OS="Win32" 
Executable="true">Win32/UefiPrint.exe</Filename> 
<Filename OS="Win64" 
Executable="true">Win64/UefiPrint.exe</Filename> 
</Tools> 
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